
Will you still be using your CoCo 
in the year 2000? There should 
STILL be a magazine to support 
you (and OS-9 68K) if you are! 



did anyone notice.. 

THIS IS THE FIRST ISSUE OF VOLUME FIVEH! 

FOUR SUCCESSFUL YEARS HAVE WSSm 
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I hope I got your attention with 
♦^e slight cover changes and the 

.oCo 2000' headline. Basi- 
cally, I am committing to produc- 
ing this magazine through the 
year 2000. That is about three 
more years. Where we go t)e- 
yond that is up to you, the read- 
ers and subscribers. As long as 
I have interesting things to print 
and enough subscribers to 
make the work worthwhile, we'll 
continue printing even after 
2000. 

What is worthwhile? We start 
our fifth year of publication with 
this issue. In this time, I have 
posted profits twice, the best 
year (nothing broke and had to 
be replaced!) was the last one 
at about $1 ,000. Previously I've 
posted mayfc>e $250 in profits. 

I said "profit", but I mean that 

>ry loosely! That is basically 
what I got out of printing the 
magazine. I have upgraded my 
computer equipment several 
times in order to make publish- 
ing easier, and have had to re- 
place a few items that just quit. 
Of course I use my equipment 



for other things, so I get a little 
pay-back by having a little extra 
money to buy better equipment 
than I may othenvise have. But 
I pay myself nothing. 

That profit mentioned is basi- 
cally the magazine's surplus, 
which is held just in case some- 
thing does break or I feel that 
something needs to be up- 
graded. Very rarely I will make 
a personal purchase from my 
business account that I can't 
write off as a business expense. 
That is all I get for producing the 
magazine. And this is mostly off- 
set for the expenses I have at 
home (like the extra power, 
some telephone time, etc.). 

The first two years had eight 
issues, the last two six. So that 
is 28 issues altogether. It takes 
an average of 30 hours work to 
produce, assemble, and mail 
each issue. That comes to a to- 
tal of 840 hours of labor. Divide 
$1 250 by 840 and you get $1 .50 
per hour. 

While this is hardly enough to 
think about making the maga- 
zine, there are peripheral re- 



wards. One already mentioned 
is that my computer equipment 
is a total business write-off. So I 
get my computer stuff basically 
for free. Then there are the trips 
to Chicago and other fests. 90% 
of the expenses come from my 
business account And there are 
the contacts with subscribers, 
and the joy of providing some- 
thing useful for others. 

I have to ac^it, I don't print this 
magazine for the money! It does 
a little better than break even. 
That is enough for what is basi- 
cally a hobby business. I just 
hope you appreciate the fact that 
I am willing to go to so much 
trouble for so little by continu- 
ing to subscribe and support 
others who work for as little or 
even less (such as Glenside 
CoCo Club and Ron Bull, who 
put on fests this year) to sup- 
port the CoCo and OS-9 hobby- 
ist communities. 
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At306 Trials, Tribulations, and 
CORRECTIONSIII 

Good news that it wasnl the actual 
"last" cocofest. 

That was a helpful! discussion of 
partitions. Now I know what those hOa. 
hOb descriptors are fbf; i thirtk that was 
never explained and I never knew 
enough to ask. But doni they rfeM to 
be included in the bootfiie?? To make 
several partitions do you have to run 
fbitpat several times? What do you use 
in place of the AiOfntt which sets the 
system to bypass the write lock so you 
CAN format? I think I know a way 
around but thought you ought to tell it. 

In your discussion preceeding parti- 
tioning I think there is a trouble. The 
sector size is 512 (bytes), not 512 ki- 
lobytes. So with map capability of 
64000 bytes I think capacity woukl be 
34M. By using cluster size 16 I think 
the map wouM address 64000 x 81 92 
- 524M . In other words a 2S6k file 
would need 32 clusters and really 
wouUnt waste a lot of space— at worst 
8192 bytes. 

That's interesting about running the 
vga adapter card on a pc to initialize 
it. That ought to save a gang of 
at306boot time in the pc mode. But I 
suppose yet another ROM than I have 
is required to take advantage of it. 

The spread sheet program I was us- 
ing on mml doesnl run on at306. and 
VED only sort of runs. IVe had to use 
pc and I sure miss the multiple win- 
dows which are available on os9. 

Fran Walters 

721 30.3067©CompuServe,COM 

1) Yes, that there will be anott^er 
Chicago test is good news indeea And 
donttbrget about the PA fast! 

2) The drivers tor each partUion you 
wish to use (hOa, hOb, etc) must be 
loaded in your bootnie, as you correctly 
obsen/ed. hOhnt is ONLY used to for- 
mat a drive with a no partitions.,, the 
entire drive is u^d as a single parti- 
tion. When the partition drivers are 
used, each partitton is formatted indi- 
vidually with the format command, 
there is no locking done. 

3) You are absolutely correct! I in- 



tended to write 512 BYTES, not KILO- 
BYTES!! Sorry about all the confusion 
this caused. You weren't the only one 
to point this error out! The 64KbX map 
uses one bit per sector. 64Kbytes*8 
bits/byte * 5f 2 bytes/sedor ' 2S6MB 
per partition. This should dear up your 
math!! 

4) The VGA card seen^ to remem- 
ber some s^Gngs from the PC, We're 
not sure exactly what transpires here, 
Cart is looking into it. We only know 
that some PC VGA cards wont work 
in an AT306 iurtil they have been in- 
stated in a PC first. Has no effect on 
booting or the AT306 ROMs, or vice- 
versa. 

5) What spreadstteet are you usk)g 
on the MM/1? If it uses tenncap, it 
should wor1( on the AT306. Ifitissome- 
how MM/1 hardware specific or re- 
quires K-windows, H won't worfc You 
may warn to contact Bob VanDerPoel 
abod VED. 

1024 or 1000 ^ 1 Megabyte? 

I believe your explanation of fonmat- 
ted versus unformatted capacity to be 
In error. An IDE hard drive with 1048 
cylinders, 1 6 heads, and 63 sectors per 
track has 1048*16*63*512 bytes of 
storage, or 540,868,608 bytes. Hard 
drive manufacturers define a mega- 
byte as one million bytes and not 
1,048,576 (1024*1024) as memory 
manufacturers do. 540,868.608 di- 
vkjed by 1.048,576 gives 515.8125 
megabytes of storage, which is 516 
megabytes as you wrote (p8 col3 top). 

I do not see that as a devious mar- 
keting ploy. Originally, the term "kilo- 
byte' emerged because someone no- 
ticed that 2''10 is approximately 10^3 
(1024 vs 1000). It is a good approxi- 
mation for small amounts of bytes, but 
gets less accurate as the number of 
bytes increases. 

Memory makers are tied to the ap- 
proximation because the number of 
bits in their memory chips is a power 
of two. Hard drive makers are not tied 
to the approximatton because they can 
make the hard drive any size and not 
just powers of two. If I made a hard 
drive that hekJ 540 million bytes then 
I, too. woukJ call it a 540MB drive and 
not a 516MB hard drive. 



I am looking forv/ard to the next is- 
sue and more news about the AT306. 

Paul R. Santa-Maria 

Ann Arbor, Michigan, USA 

paulQorchard.washtenaw.cc.mi.us 

You are irtdeed correct. Hard drive 
manufacturers use the estimated 1000 
bytes while memory and most other 
peripheral manufactures use the true 
measurement of 1024. Some hard 
drive rrmnufacturers will state the for- 
matted size of a drive, wtUlesonwgive 
the imformatted capacity. So my ex- 
plarwtion of why that particular drive 
formatted to 516MB instead of the ad- 
vertised S40MB was hcorrect, as your 
excellent math sttows. 

The reason hard drive manufactur- 
ers use the larger numbers, however, 
ismarketkyg. The manufacturers know 
that the nun^)ers wit be less than ad- 
vertised OTKe the equipment is put h 
use. There have been many times that 
a novke wUI ask computer magazines 
why they bought a S40MB or 600MB 
drive and only get S16MB of storage 
space. The 540 number is more im 
pressive, yet not totally untrue, so the 
oMkeOng arm deckled to use those 
numbers. Some go the step furrier and 
advertise something like a 600MB ca- 
pacity for the same drive 
(unformatted... ami I estimated the 
unfonnatted capactty, I'm not sure how 
much room sector marking actually 
takes, but lis a good amount one mkl- 
size drive). They get by with this be- 
cause al three numbers (51 6, 540, and 
600) are accurst, true numbers. But 
(hey are misleading to the publk. 
When you put the drive in use, It is still 
a 516MB drive. The consumer 
shoukkii have to be a math whiz and 
familiarwMhal the numbers just to buy 
a drivel l4owifit was common to actu- 
ally use one of these drives 
unfonnatted or the computer reported 
capacity as an approximatton, I couki 
see using those 'Memate" numbers. 
But when I buy something, I like to 
know what the capacity is without hav- 
ing to do a tot of mental 
math or take atong a cal- 
culator. That shoukin't 
be much to expect! 

tfm world of 68' micros pago3 




Sundog Game Crack 

Crack your Sundog games so they can be backed up for safety! 



John Riddle 



NOTICE: Sundog games are still sold 
, Rick's Computer Enterprise, Box 
276, Liberty, KY 42539. This program 
was written so ttiat legitimate owners 
will be able to baclcup ttieir software for 
safolceeplng. It is IU.EGAL to copy and 
sell or give away copywritten software. 
If you want a copy of one of the men- 
tioned games, drop Rick's a note and 
askforapdceiistl 



Several people I know requested info 
on backing up sundog games, so I 
whipped up a udtty to automatk:aBy crack 
some of them so ttiey can be backed up 
and stored in a safe place. Supported 
so far : Sinistar, Contras, Photon, Quest/ 
Thekla, and Paladin's Legecy. Support 
for Kyum Gal: To Be Ninja wi be added 
soon, and support for al Sundog games 
wi be added eventuaHy. 

To use the crack, first make a backup 
of d»k 1 of whkiiever Sundog games you 
want to remove ttie copy protectkxi from. 
You'l need a backup utflity which won't 
abort wtien it has read errors on track 0, 
because track is the norvstandard-for- 
^atted track on the Sundog dsks. Once 



From: Detmia Batbory-Kitsz 

m toSkml I've been hiding out 
In Vermont, bnt mince it's the 
10th anniveisary of my com- 
pany Green M oontaln Micso'a 
demise, I thonght tt mi^t be 
time to put in an appearance 
here* 

About 150 copies of 'Learn- 
ing the 6809' (book only) re- 
main, which I*d be happy to 
offer at $10 postpaid to any- 
one Interested* If at leaat 10 
people also want the original 
tapes, rd be pleased to make 
up a aet of those as welL 

One of these days lH tell my 
own tale ... amusing indeed... 

Dennis Bathory-Kitsz 
RD 2 Box 2770 
Cox Brook Road 
Northfield, \%niiont 05663 

<bathoiy@iiialtedmedia.com> 
Malted/Media: 
http://www.nialtcdnicdia com/ 



you have that, run sur)crack.bas on the 
backup and it wi automatk^ally patch the 
appropriate bytes to remove the copy 
protection. 

The crack works by using DSKCON 
(rom hook at k>catk>n 551 35 dec.) to read 
in a certain track and sector on the d»k. 
For example, optk>n 3 is Photon, so the 
program wi goto fine 300, and set up the 
track, sector and offset vari>le8. The off- 
set is ttie positkMi in the sector wtiera the 
bytes that need to be patched reskle. 

After that, ttie sutKoutine at ine 1000 
first finds where in memory DSKCON is 
currently storing its data variables. Line 
1010 wil tt)en do a read operatkm on 
drive 0, track 34, sector 6 into memory 
k>catk)n 1024 (whk:h is the text screen). 
I pk:ked tlie text screen because it is a 
'safe' memory k)cation for this applca- 
tion, and you get a nk:e view of the sec- 
tor that was patched. 

Then in ine 1020, the offeet variable 
is used to get to the exact k>cation in the 
sector of what needs to be patched, 
whKh is a subroutine cal using JSR. That 

3 byte in8tnx:;tk>n is replaced with 3 NOPs. 
The NOP byte code is 12 hex. The first 

4 games are cracked by puting NOPs 
over the JSR cal whk^h reads in track 
and checks some codes on it 

The last game is cracked by changing 
the executkxi address in the auto-start 
kMider. This is because the copy protec- 
tkxi is sightly dfferent on that game in 
whKh it does the copy protectkm check 
right away. This alows for the crack to 
be a simple change to an executkxi ad- 
dress. The first 4 games do other things 
(dteplaying graphk»l sundog k>go, etc) 
before doing the copy protectkxi check. 

line 1030 writes the modffied sector 
back to disk. Nottee that the first poke 
command controls ttie operatkxi (2>read 
and 3'write). After the patch is appled, 
the game wi bad normaly since the sii>- 
routine to check the copy protected track 
has been blanked out 

This is not the final version of the 
patcher, though it wi be a few months 
before I have a chance to perfect it (edh 
tor this artKie was originaly written in 
May, so checkl). If anyone needs some- 
thing clarified let me know. My address 
is: 

312 E. Maple Road 

LinthkumMD 21090 

E-mal: jriddle®ciark.net 



1 'SUNCRACK VI .0 - UTIUTY TO 
•CRACK* (NOT COPY) SOME SUNDOG 
GAMES 

2 'BY JOHN RIDDLE MAY 22, 1997 

3 'FIRST BA.CKUP SUNDOG DISK 
EXCLUDING TRACK 

4 'THEN Ri,iN THIS PATCH ON THE 
BACKUP 

5 'METHODS: #1,2,3 & 4 - JSR KILL. #6 - 
EXEC ADDRESS CHANGE 

10 F=0:CLS:WIDTH32 

20 PRINTOg/SUNCRACK VIO" 

30 PRINT:PRINriNSERT APPROPRIATE 

GAME DISK AND SELECT WHICH 

GAME TO CRACK* 

40 PRINTPRINT-I) SINISTAR'.-^) THE 

CONTRAS" 

50 PRINT:PRINT"3) PH0T0N'/4) 

QUESTATHELDA' 

60 PRINT:PRINr5) PALADIN'S LEGACr 

70 A$=INKEY$:IF AS^"" THEN 70 ELSL 

IF A$= 'r THEN 100 ELSE IF A$=T 

THEN 200 ELSE IF A$=T THEN 300 

ELSE IF AS^'r THEN 400 ELSE IF A$-= 

•5" THEN 500 ELSE 70 

100 T=30:S»12:O=AH7e:GOSUB1000: 

GOTO 2000 

200 T=3:S=11:O=&H4B:GOSUB1000: 

GOTO 2000 

300 T=34:S=e:O=&H84:GOSU81000: 

GOTO 2000 

400 T=2:S=15;O==&H7E:GOSUB1000: 

GOTO 2000 

500 T=1:S=5:O==&HC8:F=1:GOSUB1000: 

GOTO 2000 

1000 A=PEEK(&HC006)*256+PEEK 

(&HC007) 

1010 POKE A,2:POKEA+1,0:POKEA+2J: 

POKEA+3,S:POKEA+4.4:POKEA+5.0:EXEC 

55135 

1020 IF F«0 THEN POKE 1024+O,&H12: 

POKE 1024+O+1,&H12:POKE1024+O+2. 

&H12 

1025 IF F=:1 THEN POKE 1024+O.aHo2: 

POKE 1024+O+1.&H51 

1030 POKE A,3:POKEA+1,0:P6kEA+2T: 

POKEA+3 ,S:POKEy<+4.4:POKEA+5,0: 

EXEC 55135 

1040 RETURN 

2000 PRINTTHE GAME IS NOW 

CRACKED * 

2010 PRINTTHE DISK CAN NOW BE 

COPIED USING STANDARD" 

2020 PRINTDISK BACKUP PROCE- 

DURES.* 
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Hacking the Orchestra 90 Pak 

The CoCo as a Digital Sound Recorder 



Robert Gault 



Background 

There are many good artides in past 
issuee of Coco magazines describing code 
that permits d^jital recording of sound via 
the joystick inputs. There were also some 
commerdai progranra that turned the Coco 
into a mini recording studio and offered 
sophistk^ated editing actk)n. The real ques- 
tion is were these programs capak)le of 
good sound quaity? Let^s k)ok at the theo- 
retical software limitattons of a computer 
with a 2MHz clock and at a hardware 
project with the aim of Improving on these 
limitations. 

The Coco incorporates a six tsit ADC/ 
DAC (anak)g to dKlital / dKjital to anak>g 
converter.) This means that there are 26 
or 64 dtecrete signal levels that the DAC 
can represent Can 64 dncrete signal lev- 
els produce HiFi, mediumR, or no fkJe^- 
Ity? Sound levels are generally reported 
in units of dedbels (dB). The best HiFi 
systems, whether anatog or digital, have 
about a 90d6 dynamic range. A 16-bit 
compact disc player is theoretically ca- 
pabie of a 96dB dynamc range. The dech 
bel is a k>ganthmc number, and If related 
to voltages as in the Coco DAC, the for- 
mula is dB = 20 tog (EiyE2). Specificaly, 
dB = 20 tog (64/1) ~ 36. This is pretty aw- 
ful by any standard and represents ^irfy 
extreme compression and a high noise 
ttoor. Given the Coco's maximum dynamto 
range, it is truely amazing how good the 
Coco can sound when playing digitized 
music. 

You have just read the bad news on dy- 
namto range. Unfortunately frequency re- 
sponse is simiarly bad. To determine the 
DAC frequency response limitations, we 
must evaluate the best code that can be 
written to read the DAC. The code must 
be symetrical in the sense that it takes 
exactly the same amount of time to read 
each of the 64 possible DAC values. If this 
were not true, then distortion would be 
added to the sound and we have more than 
enough already. Below is a source code 
fragment lor reading the DAC. 

00100 • O/A Am CONVERTER FOR COC03; 
6BIT DAC 

00240 DAC EQU $FF20 

DACIocalsd In top 6 t)tts 2-7 
00250 KYJS EQU $FFOO 

keyboard and Joysttok output 



00460 

00460* READ DAC 

00470 TEST MACRO 

00480 STA DAC 



8St DAC level 4CYC 

00480 LDB KYJS 

check compsntor 4 CYC 

00600 BMI aO 3CYC 

00610 suBA ra 

rsaet vakis booed on comparison 2 CYC 

00620 BRA btt 3CYC 

00630 sOADDA WC 

rassl vakis baaed on oompariaon 2CYC 

00640 BRN bO 

tneedad to maintain symataryl 3 CYC 

00660 bO EQU 

00660 • 16 CYCLES THROUGH EITHER PATH 

00670 ENDM 

00680 

00600 

00740 RECLUP sampis the DAC 

00750 LDA 132*4 

preksed rsgA wRh the maximum DAC value 

2 CYC 

00780 TEST 16*4 16 CYC 

00770 TEST 8*4 18 CYC 

00780 TEST 4M 18 CYC 

00790 TEST 2*4 18 CYC 

00800 TEST 1*4 18 CYC 

00810 TEST 2-0*4r 16 CYC 

00620* 96 CYCLES 

00830 RECX STA JC+ 

store in memory 6 CYC 

00640* 104 CYCLES 



The only reasonat)le way to shorten this 
code would t>e to use a 6309 in native 
mode so that there are fewer ckx:k cydea 
per instructk>n. 

Keep in mind that this minimum of 104 
ckx:k cydea does not indude the overhead 
required to check for memory overfkTw. or 
teat for a keytx)ard stop signal. 

The maximum sampling rate at 104 
dock cydea per sample is thus: freq ~ 
179MHz / 104 - 17212 Hz. That is no* 
quite as good as It seems t>ecause signal 
theory requirea a samping rate double the 
highest usable frequency to prevent 
alasing dwtortion. 

The t>e8t dean frequency reaponse poa- 
sible for the Coco running in fast mode is 
about 8600 IHz. This is most definateiy k)w 
fkleity and worse than AM radk). Again, it 
is truely amazing just how good a wel 
written Coco digitizer program can sound. 
Can we do better?! 

CocoBlaster 

With apotogiea to a commercial prod- 
uct of simiar name, I dedded to make a 
sound card for the Coco that would im- 
prove on the imitatk^ns of the built-in AOC. 
The perfed platform for this project was 
the Tandy Orche8tra-90 Pak. This unit a^ 
ready has an d-bit DAC and input/output 
(IAD) addreasing. Al that was needed was 



the addttk>n of an 8-bit ADC for input 

I choee the ADC080(x) xpIX^A whk:i 
uaed to be sokj by Tandy (276-1792) and 
was described in the Tandy 'Semk^onduo- 
tor Reference Gukje', 1983. This unit may 
not be currentty avalable but faster equiva- 
lent devices certainly are and would be 
better for the job. The unit haa several 
deairable quaitiea: single 5v power sup- 
ply, tri-state Q-tiHt data bus whk^ can con- 
nected dk-ectly to the Coco, and a conver- 
skHi rate capable of juat barely using the 
Coco 2MHz dock. 

The ADCOSOx does a conversk>n every 
64 dock cydea. At 1.79MHz this gives a 
conversk)n rate (frequency response) of 
28KHz. Thus aignal theory says this chip 
coukJ record a dean 14KHz signal. In fact, 
the program isted betow can actualy save 
data at a maximum rate of 21KHz so the 
dean signal is reduced to lO.SKHz. By 
contrast the Coco ADC, as we have juat 
seen, la only capable of a dean 8500Hz 
signal. Unfortunately, the ADCOdOx is rated 
for a maximum dock of 1.46MHz and the 
faster Coco dock results in a conversran 
error 5% in ampitude. Thia, however, can 
be compensated for with a voltage offeet 

So far. so good. The ADC080xcan cover 
the 20-20000HZ human hearing range witf 
some dtotortk>n atwve 11 KHz. How does 
the dynamic range compare to the Coco 
DAC? Using our equatton from above, dB 
= 20 k>g (28/1) = 48. That is much better 
but not up to HiFt standards. I woukl rate 
my project, based on istening teats, with 
sound quaity somewhere t)etween that of 
AM and FM radk). 

Before leaving theory, you should un- 
derstand the impact of high quaity sound 
on storage capacity. Everything comes 
with a prKe. Sound recorded at 21 KHz on 
a 512K RAM Coco wi last about 20 sec- 
onds. Software programs running at 
14KHZ can store about 30 seconds of 
sound. About 2 1/2 double skied 40 track 
dnka are needed to save al of this data. 

Connaction Requirements 

The ADC080X needs both read and write 
signals. The ORC-90 pak has write ad- 
dressing but needs read addressing in- 
stalled, i dkl this by piggybacking a sec- 
ond 74LS138 chip onto the existing unit in 
the ORC-90 pak. A tow profile IC socket 
was sokiered onto the ORC-90 7413138 
connecting al inea except pins 5, 14, and 
15. 

Pin 5 is an 'enable" line which win be 
set permanently on tiy tying it to ground. 
Thia wi make the select Ines active for 
both read and write perkxjs. Pins 14 and 
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FARN A Systems 

Your moat complrt^ source for Color CoTfiput^r and 06-9 Informatlonl 



Podt O^ictf Box 321 
"HdiTntT Robins. GA 3109S 
Phone: 912-32d-7d59 

E-mail: d&rtfoxtfdclphi.com 



^^ 
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Mjwt^rti^ 06-9 - $30.00 

Complfftdy dt^pe on^ throu^ learning all as- 
pect© (7f 06-9 on thtf Color Computer. Ea«y 
to ft>llow Inetructiond and tutorial. With a 
dl6k fuH of abided utdltioe and doftvvansl 

Tandy* LJtUa Wonder - $25.00 

Htetory, t«ch info, hackd. dchcmatk;©, r«- 
palre... almoet EVERYTHING avafiabte for thtf 
Color Comput<jri A MU6T HA/E for ALL CoCo 
afflclandoe, both t\m and M\\\ 

Quick IMw-0itc« Guldae 

Handy llttte bookd contain the most rcfflr- 
anc«d Info k\ daey to fkid format. 6fcM makee 
thtfm uno*7tnjd*v« on your doek. Command syn- 
tax, amor cod«». dyetcm calte. ate. 
CoCo 05-9 Lw(rf II : $6.00 

oe-sie&ooo -. t7,oo 

Cornpl0t« Oloto dchamatic 90t: $15 

Compitfta eat of all Oteto ^mdxsct echemat- 
k;0. Great to havo... naiodad for ropaM 

■A Full Turn of the Scrwri $20 

t» of CoCo Info, projoct©, and tutoriate,. by 
^y DteSttffano 

*ln0kl0 Pbto'« 2 M«^ (CAT : $10 

Schamatto© and explanation of how tha 2 me0 
CoCo 3 upgrada nvorke. 



SOFTWARE: 

CoCo FarnOy ^.ecorden deet ^aak;^ rocord 
keeper EVER for tha CoCol Rac^ulrae CoCo5, 
two drlvae (40 track for 06-9) and SO (xAe. 
PECe: $15.00 06-9: $20.00 

D^iTflch Pro: $10.00 

Add ©ounde to your eA6IC and M/L pro^amel 
Vi9ry aaey to um. Rac^ulrae uoar to maka a 
elmpia cabia for sound Input through a Joy- 
stick port. (^ufcTO© CoCcQ, PECB, 512IC 

A006: Most reepected anhancamant for 
PEC&I Qoutf\c eided drfvos, 4O/d0 tracks, fast 
formats, many axtra and enhanced commandel 
Original (CoCo 1/2/3) : $10.00 
AD06 3 (CcCo 3 only) : $20.00 
Extended AD06 3 (CoCo 3 only, rec^utee 
AD06 3, support for 512K-2MB. RAM drivw, 
40/aO track drVas m6<ad) : $30.00 
ADOe 3/EAD06 3 Cooibo: $40.00 

rh(M etastar - $12.00 

Hl^ spaad ofraphkie toots for CcCo 3 05-9 
Laval IL Easily spoad up parformanoa of your 
^raphice pro^amsl Deeded aspaclalty for 
0a ma pro^rammmarsl 

Patch 06-9 - $7.00 

Latest var&tons of all popuiar utfls and new 
commands with complete documantatton. 
Auto-^stallar rec|u*Toe 2 40T 06 drives (one 
may be lar^). 



FARN A Syot^^ismo l« pidacved to 
£kryrya\jrso^ thi*^ we are now dlo- 
tributoro of thd folloivln^. for- 
merly from Northern Expoourdl 

Nat«: If yc?u r\o/^r rcc^ivod your or- 
d«r from NX, ^and m copy of 
yourcanctfjl^d chtfck alon^ with 3>5 
to cover S&H mnd ITS fill the or^lerl 

Nltrt)6-9 : $35.00 

A complete nawrfte of 06-9 Level II that takes 
advanta^ of aH foaturos of Hftachfs 6309 
processor. Easy kistall scrlpti 6309 rec^ulrsd. 

TuneUp : $20.00 

If you dont have a 6309. you can stIU take 
advanta^ of some of the NItro softwara tech- 
nok>^ Many 06-9 Level II modules rawrlttan 
for improviod spaad with the stock 66091 

Thexder 06-9 

6hart#ial 06-9 : $25.00 each 

Transfers your ROM Pack ^me code to an 
05-9 disk) Please send manual or ROM Pack 
to verify ownarshlp of orlgfcial. 

Rusty : $20,00 

Launch PEC& pro^ame from 06-91 Altows 
\oadhq of soma programs from hard drivel 



Complete computer 0yetem& baeed or\ the AT306 i?OBrd from Krtfider EI<50tronlc9. Syeteme are 
compl<rt^ly s<?tup and ready to go. Juet add a VGA monitor {or we can supply that too)\ 



Both systems include: 

16 bit PC/AT I/O bus wtthflw sloto 

MC68306 CPU «t 16.e7MHz 

4 30pinSIMM«ock«te 

IDE Hard Drtvs Intarface 

1.4MB Fk)ppyOrlv« 

TW0 16 byte fMt MTlal ports (up to 115K baud) 

BkJIrecttonal parattBl prtntor port 

RasMlmsclocfc 

PC/AT keyboard 

Desktop Cass arxJ Pcwwr Supply 

(mInMovmr case opttonal. no coetl) 
BASIC (resembles Microeoft BASIC) 
MGR Graphical WMowIng EnviTDnment 

with ful documentation 
-Personar OS-d/68000 V^ 3.0 

(Industrial with RBF) 
rivers for Tseng W32I 

and Trfclsnt 8900 VGA csrds 
Drivers for Future Domsin 1680 

and Adsptsc AAH1 Sxx SCSI cards 

Many other utilities and tools 

P9g96 th9wort(lofWwiGn» 



FARNA-11123 Includes: 

2MB RAM 

300MB Hard Drive (was 200!)* 

Trident 8900 1MB Video Card 

$960.75 



FARNA*11225 includes: 

2MB RAM 

500MB Hard Drive* 

Tseng W32i 1MB Video Card 

$1114.47 



^Thl»mfh9S»MAU£STmmiumcifonmttmd9imcmmfwa9ti9. 



HACKERS MINI KIT (FARNA-11100): Includes AT306 board, 08-8 and drivers, 
util software, assembly Instructions/Ups, TB900 1MB video card. Add your own 
case, keyboard, drives, and ffionHprl ONLY $6001 



Call f6r a quote on diffsrent configurations and components. 
Warranty Is 90 days for labor & setup, componants Imltad to manufacturars wanranty. 

Microwara Programmers Package - 

Ucensed copies of Microwara C compiler, Assembler, Debugger, 

Basic, and many other toolsl 

With system purchase: $65.00 Without systmn: $65.00 



1 5 are outputs which must not interfer with 
the originai ORC-90 lines. Rn 14 will t)e 
left unconnected. Pin 15 with go to the 
A1DC080X chip select fine, pin 1. 

One more support IC wi t)e needed to 
supply the read / write signals. The Coco 
uses a single read/write (R/W*) line with 
selection based on logic. The ADC080x 
requires its separate read and write (R pin 
2. W pin 3) lines to have the same logic 
value. We need to decode the cartridge 
Kne 18 into separate read / write fines us- 
ing and inverter for the R line. I used a 
74LS02 NOR device with one input 
grounded as an inverter. 

The data fines 00-07 of the ADCOSOx 
must be connected to the Coco bus. I 
found the easiest way was to use rit>bon 
cable to connect the ADCOdOx pins 18-11 
(0(MD7) to the ORC-90 1C1 pins 11-19 (00- 
07.) There are several other connections 
which you can get from the schematic di- 
gram below. 

To access the new circuit, I chose the 
simple optton of co-opting one of the ORC- 
90 RCA jacks. This made the pak a mono 
unit but the AOC080x is only a single chan- 
nel anyway. The input to the IN-*- line of 
the AOC080X needs to be biased at 1/2 
the power supply for maximum input dy- 
nanruc range. This was done with a simple 
resistor voltage dMder and isolated from 
OC ofTiBet by a capacitor 

In the event that you wish to keep ste- 
reo output from the ORC-90, just put a 
double pole single throw switch at the RCA 
jack to select the original output or AOC 
input 

With the hardware installed, the Coco 
is now ready for new software. 

Tha Software 

A combination of Basic and machine 
code makes the new hardware function. 
When the program is started, the main 
screen is seen. 

C0C03 512K AUDIO DIGITIZER 

BY R.GAULT 

SELECT YOUR FUNCTION 

(R)ECORD 

(P)LAYBACK 

(S)ET LEVELS 

(L)OOP PLAY 

(M)ONITOR (D)ISK I/O 

(H)ARDWARE ADJUST 

BITS, FREQUENCY 
MMU BLOCKS 

(Q)UIT 

SPACEBAR TO KILL FUNCTION 

The Set Levels and Hardware Adjust 
screens are interesting. You can select the 
number of bHs used per word, the sam- 
pling rate, and the length of sample cap- 



tured. The level screen presents a VU 
meter cafibrated in dB with both fast and 
average response. Sound quality is not 
altered even though the computer is busy 
drawing graphk: paterns. 

8-BIT VU METER 
by R.Gautt 
!!Trim volumetl 

CURRENT VALUES: 

20933 HZ SAMPUNGRATE 
8 BITS PER SAMPLE 
/ 53 FIRST/LAST MMU BLOCK 
21.00 SEC. SOUND SAMPLE 

SELECT (F)REQ. 
(B)ITS 
(M)MU BLOCKS 

Source Coda 

A Coco3 with 512K RAM and 40 track 
drives is required to run the Bask: and m/ 
I routines. Change the DISKIO code for 
35 track drives. On systems with Muttl- 
Paks, the ORC-90 must be in sk>t #1. The 
fotk>wing machine language source code 
is in EDTASM6309 format, but can easiy 
be adapted to straight EDTASM or other 
edftor assemblers as no 6309 spedflc code 
was used. The text and graphk: outputs 
use the PMOOE3 graphk: and Lowres text 
screens to preserve more memory for 
sound. Notice how the Highres graphic 
screen ROM routines are used to print to 
the PM0DE3 screen. 

00100 •DACTMR3 
00110 

00120 * D/A AA) CONVERTER FOR C0C03; 
88rr DAC; 51 2K REQUIRED 
00130 * REQUIRES ORC-90 PAK WITH 8BIT 
AOC MOO 
00140 

00150 • USES HPRINT ROUTINE TO PRINT 
TEXT ON PMO0E3 SCREEN 
OOieO INCLUDE OISKIO 
00170 

00180 BFFRO EQU 

FIRST MMU BLOCK OF MAIN BUFFER 
00190 BFFRL EQU $36 

WOULD BE $31 TO EXCLUDE H.QRAPHICS 
AREA 

00200 BUFFR1 SET $8000 

00210 EBUFR1 SET $A000 
00220 BUFFR2 EQU $2600 
00230 MPI EQU $FF7F 

00240 PIAO EQU $FF22 

00250 PIA1 EQU $FF23 

00260 DAC8 EQU $FF7B ORC- 

90 pok addrstt Ine 

0QZ70KYJS EQU $FF00 joy- 

stick output 

00280 MMSLOT SET $FFA4 
$800O-$9FFF 

00290 ADCTRG EQU $FF7A ADC 
TRIGGER PORT 

00300 ADCREO EQU ADCTRG ADC 
READ PORT 
00310 GFIRQ EQU $FFS3 GIME 



FIRQ PORT 

00320 MAXLN EQU 

1 5+1 28^+BUFFR2+50*32 

00330 DELAY EQU 20 V U 

METER DECREASE DELAY 

00340 

00350 SETDP $FF 

00360 

00370 ORG $7000 

00380 

00300 ZRECRD JMP RECORD 

00400 2PUY JMP PUY 

00410 ZLEVEL JMP LEVEL 

00420 ZMNITR JMP MONITR 

00430 ZCLOCK JMP CLOCK 

00440 

00460 FREQU FOB 179 DE- 

FAULT »20KHZ 

00460 Brrs fcb 255 e - 

FAULT -8 BITS 

00470 

00480 8UFFR0 FCB BFFRO D E - 

FAULTS ARE ABOVE; SET FROM BASIC 

DRIVER 

00400 BUFFRL FCB BFFRL 

00600 

00510 DRIVES FCB -1,-1.-1 

DRIVE NUMBERS ARE SET FROM BASIC 

00620 

00630 RECORD BSR SETUP 

00540 LDA BUFFRO 

00660 STA MMSLOT 

00660 RECLUP SYNC WAIT 

UNTIL TIMED OUT 

00670 LOB ADCREO READ AOC 

00680 LDA GFIRQ CLEAR FIRQ 

00600 STD ADCTRG TRIGGER ADC. 

SEND VALUE TO DAC 

00600 RECX STB M SAV! 

AOC VALUE 

00610 CMPX «EBUFR1END OF 

BUFFER UO BLOCK? 

00620 BNE RECX2 

00630 LDX *BUFFR1R E S E T 

POINTER TO START OF BLOCK 

00640 LDA MMSLOT UPDATE MMU 

VALUE 

00650 ANOA «$3F 51 2K COCO; 

DIFFERENT VALUE NEEDED IF 1 MEG COCO 

00660 INCA 

00670 STA MMSLOT 

00680 CMPA BUFFRL REACHED 

LAST MMU BLOCK? 

00600 BNE RECLUP 

00700 BRA RECXIT 

00710 RECX2 LDA KYJS TEST 

KEYBOARD FOR SPACEBAR 

00720 BtTA #8 

00730 BEQ RECXIT 

00740 BRA RECLUP 

00750 RECXrr LOD #$3C36 

00760 STA MMSLOT RESTORE MMU 

00770 STB $FF03 RESTART IRQ 

00780 DECS 

00790 STB $FF23 SOUND OFF 

00800 DECS 

00810 STB MPI RESET MPI TO 

$33 

00620 LOD #$CC 

00630 STB $FF90 RESET GIM^ 

REGISTERS 

00640 STA GFIRQ CLEAR GIME 

FIRQ 

00650 STA $FF01 SET FOR 

SLOW TIMER 



ttmwoildofdirmicfQf p^g^T 



ooeeo STA $ff94 clear timer 

00670 STA $FF96 • • 

00880 LOB FRQIMG RESET FIRQ 

ROUTINE TO ROMS 

00890 LOX FRQIMG^I 

10 STB $10F 

.0 STX $110 RESET FIRQ 

00020 TFR A,DP 

00830 ANDCC «$AF 
00040 RTS 
00060 

00080 SETUP ORCC #$60 

00970 LDO #$FF7F 

00060 TFR A,DP 

00090 STB $FFQ2 A L - 

LOW TEST FOR SPACEBAR 

01000 LOA «%11011100 
C0C01 ,MMU,FIRQ.C-RAM,DOS 

01010 STA $FF90 ACTI- 

VATE MMU 

01020 LOD «$343C SELECT CAR- 
TRIDGE AS SOUND SOURCE 

01030 STA $FF01 MUXA^ 

01040 STB $FF03 MUX B«1; CART 
SOUND ON, VERT IRQ OFF 

01060 LOA #$3C 

01060 STA $FF23 SOUND ON 

01070 LOA $10F SAVE FIRQ 
PATH 

01060 LOX $110 

01090 STA FRQIMG 

01100 STX FRQIMG+1 

01110 LEAX FIRQ.PCR I N - 

STALL AN FIRQ ROUTINE EVEN IF 

01120 STX $110 I T 

WONT BE USED: IT IS USED BY LEVEL 

'^MSO LOA #$7E ROU- 

E. 

V.I40 STA $10F 

01160 LOA #$20 

01160 STA GFIRQ FIRQ TIMER ON 

01170 STA $FF91 FAST CLOCK 

01180 LOD FREQU SET BY BASIC 
DRIVER 

01190 STD $FF94 SET TIMER 
VALUE 

01200 LOX #BUFFR1USED BY 

RECORD AND PLAY; NOT LEVEL OR MON^ 
TOR 

01210 RTS 

01220 FRQIMG RMB 3 
01230 
01240 

01250 PLAY BSR SETUP 

01260 LOA BUFFRO 

01270 STA MMSLOT 

01280 

01290PLYLUP SYNC THIS 

WILL MAKE PLAY RUN AT THE SAME RATE 

AS 

01300 LOA GFIRQ THE RECORD 

ROUTINE. 

01310 * * * 

01320 LOA :X* 

01330 ANDA BITS SET BY BASIC 

DRIVER 

01340 STA DAC8 SEND SOUND 

TO 8-BIT DAC 

360 CMPX #EBUFR1 

J60 BNE PLYX2 

01370 LOX #BUFFR1 

01360 LOA MMSLOT 

01390 ANDA #$3F 
01400 INCA 

01410 STA MMSLOT 

p«0ta ttmwofki of 69" micros 



BUFFRL 

PLYLUP 

LBRA RECXIT 

LOB KYJS 

#8 

PLYxrr 

PLYLUP 



01420 CMPA 
01430 BNE 
01440 PLYXrr 
01450 PLYX2 
01460 BITB 
01470 BEQ 
01480 BRA 
01400 

01500 SETOP 
01510 

01 520 • CLOCK SPEED TEST; A«$C3 AT 2MHZ 
A*$E1AT1MHZ 

01530 * CLOCK FLAG SET MEANS SLOW 
1MHZ CLOCK RATE 
01540 

01 560 CLKFLG SET $73FF 

01560 

01570 CLOCK CLRA 

01580 STA CLKFLG.PCR 

01500 PSHS CC 
01600 ORCC #$60 
01610 SYNC 
01620 TST $FF02 

01630 TLOOP INCA 

01640 TST $FF03 

01660 BPL TLOOP 

01660 CMPA #$00 
01670 BHI CLKXJT 

01680 COM CLKFLG.PCR 
01690 CLKXrr PULS CC.PC 

01700 

01710 SETOP $FF 
01720 
01730 

01740 * THIS ROUTINE IS TOO SLOW TO AL- 
LOW THE USE OF SYNC; INSTEAD AN FIRQ 
01750 * ROUTINE IS USED TO SAMPLE THE 
ADC; THAT MAINTAINS HIGH QUALITY 
SOUND. 

01760 • THERE IS NO NEED FOR PERFECT 
SYNC OF THE VU METER WITH INCOMING 
SOUND. 
01770 

01780 LEVEL LBSR SETUP 

01790 CLR GFIRQ DON'T USE 

TIMER 

01800 CLR MPI POINTTOORC- 

90PAKINSLOT#1 
01810 LOA #$30 
01820 STA P1A1 

01830 STA AOCTRG INITIATE ADC 
HARDWARE 

01840 LBSR LABEL 
01860 LOD #MAXLN 
01860 STD MAXV 

01670 LOB #OELAY 

01880 STB WAIT 

01890 LEVEL2 LOX 
#BUFFR2>1&4^0*32 

01900 ANDCC #%10111111 E N - 

GAGE FIRQ 

01910 LEVLUP LOB KYJS 

01920 LEVX BITB #8 

01930 LBEQ RECXIT 
01940 LOA ADCIMG 

01960 SUBA #6 USED TO COR- 

RECT HIGH SPEED ADC ERROR 
01960 TSTA COMPENSATE 

FOR CONSTANT Z5V OFFSET 
01970 BPL NORM 

01980 NEGA 

01990 NORM LOB #32 3 2 

BYTES PER GRAPHIC SCREEN UNE 
02000 MUL 
02010* ANOB #2S6-(BYTES:PER:L1NE) 



ONLY NEEDED IF REG.B NOT = BYTES 
02020 LEAY O^X POINT TO COR- 

RECT BYTE 

02030 PSHS Y SAVE REG.Y 

FOR COMPARISONS 

02040 CMPY MAXV PREVIOUS 
HIGH VALUE 

02060 BHS LOWER GRAPH IN- 
VERTS DIRECTION 

02060 STY MAXV SAVE NEW 
HIGH VALUE 

02070 LOWER LDY MAXV 

02080 CMPY #MAXLN 
02000 BEQ SET 

02100 LDA #%10101010 

BACKGROUND COLOR 
02110 DEC WAIT USED TO GIVE 
FAST RISE, SLOW FAU TO PEAK IND. 
02120 BNE CLRLP2 
021X LOB #DELAY RESET SLOW- 

DOWN COUNTER 
02140 STB WATT 
02160 CLR .Y ERASE THE 

MAX PEAK INDICATOR 
02160 LEAY 32,Y UPDATE 

POINTER BY ONE UNE 
02170 STY MAXV SAVE NEW 
MAX VALUE POINTER 

02180 CMPY #MAXLN DID WE REACH 
THE BASE UNE? 
02100 BEQ SET 
02200CLRLP2 STA ,Y SET 

PEAK INDICATOR TO FOREGROUND COLOR 
02210 LEAY 32,Y NEXT UNE 
02220 CMPY .S REACHED THE 

CURRENT VALUE YET? 
02230 BHI CYCLE GONE PAST IT 

02240 BEQ SET IF PEAK NOW 

SAME AS CURRENT VALUE 
02260 * CLEAR A GAP BETWEEN THE OLD 
MAXIMUM INDICATOR AND CURRENT VALUE 
02260 CLRLUP CLR .Y SET 

TO BACKGROUND COLOR 
02270 LEAY 32,Y NEXT UNE 
02280 CMPY ,S REACHED THE 

CURRENT VALUE YET? 
02200 BLO CLRLUP 
02300 * FILL AN INDICATOR COLUMN 
THROUGH MAXUNE VALUE 
02310 SET LDA #$FF 

02320 SETLUP STA ,Y SET 

TO FOREGROUND COLOR 
02330 LEAY 32,Y NEXT UNE 
02340 CMPY #MAXLN REACHED THE 
BASE UNE? 

02360 BLS SETLUP IF NO OR THE 

SAME 

02360CYCUE LEAS 2,S R E - 

SET SYSTEM STACK -PULS REG.Y" 
02370 BRA LEVLUP 
02360 

02300 ADCIMG RMB 1 A TO 

CONVERTOR IMAGE; FILLED BY FIRQ 
02400MAXV RMB 2 AD- 

DRESS OF MAX VOLTAGE LEVEL 
02410 WAIT RMB 1 D E - 

LAY VALUE FOR MAXV DECREASE RATE 
02420 

02430 * FIRQ: THIS ROUTINE READS ADC, 
SENDS VALUE TO DAC, STORES VALUE 
02440 * IN ADC-IMAGE, CLEARS GIME 

FIRQ, TRIGGERS ADC. 
02460 * REGISTERS CHANGED: NONE 
02460 
02470 FIRQ STD REGIMG 



02480 LDB ADCRED READ THE ADC 

02490 LDA PIAO CLEAR CART 
FIRQ 

02500 STD ADCTRG TRIGGER THE 
ADC; SEND SOUND TO DAC 

02510 STB ADCIMG UPDATE 
IMAGE 

02520 LDD REGIMG 
02530 RTI 

02540 REGIMG RMB 2 
02550 

02560 LABEL PSHS X,YU 

02570 LDU #$F09D 
HSCREEN ASCII SET 

02580 LDX #BUFFR2+4M6^ 

02500 LEAY MES1.PCR 

02000 BSR PRINT 

02610 LDX #BUFFR2M*71*32 

02620 LEAY MES2,PCR 

02630 BSR PRINT 

02640 LDX #BUFFR2+4*97*32 

02660 LEAY <MES3.PCR 

02060 BSR PRINT 

02670 LDX #BUFFR2+4+123r32 

02680 LEAY <MES4,PCR 

02600 BSR PRINT 

02700 LDX #BUFFR2*4+148*32 

02710 LEAY <MES5.PCR 

02720 BSR PRINT 

02730 LDX #8UFFR2*4*174*32 

02740 LEAY <MES6,PCR 

02750 BSR PRINT 

02760 LDX #BUFFR2 

02770 LEAY <MES7.PCR 

02780 BSR PRINT 

02790 LDX #BUFFR2+0*32 

02800 LEAY MES8,PCR 

02610 BSR PRINT 

02820 LDX #BUFFR2+26*32 

02830 LEAY MESO^PCR 

02840 BSR PRINT 

02860 PULS X,Y,U.PC 
02860 

02870 • THIS ROUTINE USES THE GRAPH- 
ICS PRINT ROUTINE FROM ROM. 

02880 

02800 

02900 PRINT CLRA 

02910 TFR A,DP 

02920 LDA ,Y+ GET A 

CHARACTER FROM MESSAGE 

02930 BEQ PRTS 

02940 PSHS X,Y 

02960 SUBA «$20 INDEX REG>^ 

TO ASCII SET; SUB. SPACE 

02900 LDB #8 8UNESPER 

CHARACTER 

02970 MUL 

02960 LEAY D.U POINT TO 

CHARACTER IN GRAPHICS SET 

02990 LDB »%01010101 

03000 STB $B5 

03010 LDB #8 8 BYTES PER 

CHARACTER 

03020 LPLOOP LDA ,Y+ GET 

PIXELS 

03030 PSHS B 

03040 JSR $F01A USE C0C03 

HIGH RES. GRAPHICS PRINT TEXT 

03060 LEAX 30^ MOVE 

SCREEN POINTER TO NEXT UNE 

03060 PULS B 

03070 DECB UPDATE 

COUNTER 

03080 BNE LPLOOP 



03090 PULS X,Y 

03100 LEAX iX MOVE RIGHT 

ONE SPACE 

03110 BRA PRINT 

03120 PRTS LDA #$FF 

03130 TFR A,DP 

03140 RTS 

03150 

03160 ' UBELS FOR THE VU METER 

GRAHtCS SCREEN 

03170 

03180 MES1 FCC /> 20B/ 

03190 FCB 

03200 MES2 FCC f* Of 

03210 FCB 

03220 MES3 FCC /- Z 

03230 FCB 

03240 MES4 FCC /-4/ 

03250 FCB 

03200 MESS FCC M2^ 

03270 FCB 

03280 MES6 FCC /-46DB/ 

03290 FCB 

03300 MES7 FCC /B-BfT VU 

METER/ 

03310 FCB 

03320 MESS FCC / byR.GMt/ 

03330 FCB 

03340 MES9 FCC /ItTrimvolumell/ 

03360 FCB 

03360 

03370 

03380 MONITR LBSR SETUP 

03390 MMLUP SYNC 

03400 LDB ADCRED READ THE 

ADC 

03410 LDA GFIRQ CLEAR THE 

FIRQ 

03420 ANOB BITS BITS SET BY 

BASIC DRIVER 

03430 STD ADCTRG TRIGGER ADC. 

SEND VALUE TO DAC 

03440 ANDB «%11111100 

03460 STB $FF20 

03460 LDB KYJS TEST KEY- 

BOARD FOR SPACEBAR 

03470 BITB #8 

03480 LBEQ RECXIT 

03490 BITB f%01000000 

SHIFT KEYS 

03600 BNE MMLUP 

03610 KLOOP LOB KYJS 

DEBOUNCE THE SHIFT KEYS 

03620 BtTB f%01000000 

03530 BEQ KLOOP 

03640 COM $530 

03550 LDA $FF03 

03660 EORA #8 TOGGLE 

BETWEEN COCO DAC AND ORC-00 PAK 

03570 STA $FF03 

03680 BRA MMLUP 

03600 

03000 END 



00100 • DISKIO: INCLUDE FILE FOR DIGIT 8 
BIT DAC 
00110 

001 20 BUFFRO SET $701 2 

00130 BUFFRL SET $7013 

00140 BUFFR1 SET $4000 

00150 EBUFR1 SET $6000 

00160 MMSLOT SET $FFA2 

00170 DSKCON SET $C004 

00180 CLKFLG SET $73FF 



00190 

00200 ORG $7400 
00210 SAVE PSHS CC SAVE 

INTERRUPT SETTINGS 
00220 ORCC »$60 KILL INTER- 
RUPTS 

00230 TST CLKFLG.PCR TEST 

COCO CLOCK SPEED AT START OF PRGM 
00240 BEQ AO DONT SPEED 

UP CLOCK IF SYSTEM CANT HACK IT 
00250 STA $FFD9 
00260 AO LDA «3 

WRITE COMMAND 

00270 LDB $7014 GET DRIVE 

NUMBER 

00280 STD $EA TELL DSKCON 

00290 CLRB 

00300 STB $EC START AT 

TRACK 
00310 INCB 

00320 STB $ED START AT 

SECTOR 1 

00330 LDA BUFFRO GET START- 

ING MMU BLOCK* 
00340 STA MMSLOT 

00360 BO LDX #32 

TRANSFER 32 SECTORS 
00360 LDY #BUFFR1 
00370 STY $EE TEU DSKCON 

WHERE TO READ DATA 
00380 CO JSR [DSKCON] 

00300 TST $F0 ANY ERRORS? 

00400 BNE SAVXrr YES7.THEN 

QUIT 

00410 BSR TSUDAT UPDATE 
POINTERS 

00420 INC $£E 

00430 LEAX -M 
00440 BNE C<p 

00460 LDA MMSLOT RESET THE 

DATA MMU BLOCK 
00460 ANDA «$3F 
00470 INCA 
00480 STA MMSLOT 

00400 CMPA BUFFRL 
00600 BNE BO 

00610 sAvxrr ldd «$3aoo 

00620 STA MMSLOT RESET TO 
SYSTEM MMU BLOCK 

00630 TST CLKFLG.PCR 

00640 BNE DO 

00550 STA $FFD8 

00660 DO STB $FF40 STOP 

DISK DRIVE 

00570 PULS CC.PC 
00680 

00600 TSUDAT INC $ED UP- 

DATE DISK SECTOR 

00600 LDA $ED 

00610 CMPA no INTO THE 

NEXT TRACK? 

00620 BNE AO 

00630 LDA #1 YES7.THEN 

RESET SECTOR NUMBER 

00640 STA $E0 

00660 INC $EC INCREASE 

TRACK* 

00080 LDA $EC 

00670 CMPA #40 END OF 40 

TRACK DISK? 

00680 BNE AO 

00600 CLR $EC RESET TRACK* 

00700 LDA $EB AT END OF 
DRIVE SEQUENCE? 

00710 BMI DO 
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00720 BNE BO 

00730 LDA $7015 GET SECOND 

DRIVE NUMBER 

00740 BRA CQ 

00750 BO LDA $7016 GET 

mo DRIVE NUMBER 

.00 CO STA $EB 

00770 AO RTS RE- 

TURN FROM UPDATES 

00780 DO LEAS 2,S FIN- 

ISHED SO RETURN TO MAIN PROGRAM 

00790 BRA SAVXIT 
00600 

00610 ORG $7460 
00620 

00630 READ PSHS CO 

00640 ORCC #$50 

00660 TST CLKFLG.PCR 

00660 BEQ AO 

00670 STA $FFDO 

00680 AO LDA «2 

00600 LDB $7014 

00900 STD $£A 
00910 CLRB 

00920 STB $£C 
00030 INCB 

00040 STB $ED 

00960 LDA BUFFRO 

00060 STA MMSLOT 

00070 BO LDY «BUFFR1 

00960 LDX #32 

00090 STY $EE 

01 000 CO JSR [DSKCON] 

01010 TST $F0 

01020 LBNE SAVXIT 

01030 LBSR TSUDAT 

'^-»040 INC $EE 

360 LEAX -i;C 

^J^0eO BNE CO 

01070 LDA MMSLOT 

01060 ANDA #$3F 
01000 INCA 

01100 STA MMSLOT 

01110 CMPA BUFFRL 

01120 BNE BO 

01130 LBRA SAVXIT 

10 FORI-0TOZREADOR:POKE 4H7014*!. 

OR: NEXrQOTO70 

20 DATA 0,2,255 

30 WIDTH32:PRINrYOU MUST EDIT UNE 1 

TO INDICATEYOUR DRIVE SYSTEM. IF YOU 

HAVE DOUBLE SIDED DRIVES, THE FIRST 

TWO NUMBERS MUST BE THOSE FOR 

THE FRONT AND BACK SIDES OF THE 

PRIMARY DRIVE." 

40 PRINriF YOU HAVE SINGLE SIDED 

DRIVES.INDICATE WHICH DRIVES SHOULD 

BE USED * 

50 PRINT^EXI SINGLE DRIVE, SINGLE 

SIDED":PRINrDATA 1,-1.-1" 

60 PRINrEX2 TWO DRIVES, DOUBLE 

SIDED-iPRINrOATA 0,2,r:END 

70 PCLEAR8:L0ADM"DACTMRT: POKE 

4HFF40,0 

80 CLOCK-4H700C:RECORD««H7000: 

PLAYBACK»4H7003:LEVEL=&H7006: DSAVE 

«AH7400:DREAO»4H74BO: MONITOR* 

H7009: P-1:EXEC CLOCK 
jQ BB«8:FREQUENCY«&H700F:BrrS= 
AH7011: POKE FREQUENCY.aPOKE 
FREQUENCY+1.171:P0KE BITS,255:' 
DEFAULTS ARE 20KHZ AND 8 BITS 
100 TMR-2.571 428671 :DEF FNFl (X)» 20033* 



(PEEK(4H701 3H'EEK(4H701 2)yTMR/RATE 
110 DEF FNF2(X)«INT(20033*{53-PEEK 
{aH701 2))mUIR/RATE+.5) 
120GOSUB410 

130 POKE66407.O:WIDTH32:ONBRK 
GOTO500 

140PALETTE12,63:PAL£TTE13,0: PAL- 
ETTE4, 63:PALETTE5,00:PALETTE6,11 : 
PALETTE7.36 

150 CLS:PRINTTAB(3)'COC03 51 2K AUDIO 
DIGrn2ER':PRINTTAB(10)"BY RGAULF 
160 PRINTTAB(6)'SELECT YOUR FUNC- 
TION* 

170 PRINTPRINTTAB(10)"(R)ECORD-: 
PRINTTAB(10)"(P)LAYBACK":PRINTTAB(10) 
'{S)ET LEVELS 

180 PRINTTAB(10r(L)OOP PLAr 
190 PRINTTAB(5)'(M)ONITOR';TAB(18) '(D) 
tSKI/O" 

200 PRINTTAB(10r(H)ARDWARE ADJUST*: 
PRINTTAB(13rBrrS. FREQUENCY" 
210 PRINTTAB(13)-MMU BLOCKS' 
220 PRINTTAB<10r(Q)Uir 
230 PRINT:PRINTTAB(3rSPACEBAR TO MU 
FU NOTION* 

240 GOSUB60a>stNSTR(1,-RPSLQDMH*. 
A$):ONA'M GOTO 240,250,280;Z70,420, 500, 
700.460.300 

250 CLS:GOSUB410:PRINTTAB(5) 'RE- 
CORDING IN PROGRESS ../: PRINT PRINT 
TAB (5)* USING";BB; 'BITS AriRATErHZ.": 
EXEC RECORD:GOT01X 
2eOGOSUB4iaGOSUB500:EXEC PLAY- 
BACK: GOT01 30 
270 CLS 

280 PRINTPRINTLEVEL CHECK „..': 
GOSUBSia EXEC LEVELRGB 
290GOTO130 

300 CLS:GOSUB410:PRINrCURRENT 
VALUES:*:PRINTRATE,"HZ SAMPUNG 
RATE":PRINTBB;"BrrS PER SAMPLE*: 
PRINTCB;T:CL-rFIRST/LAST MMU 
BLOCK':PRINTUSING'##.#r;CR;:PRINT' 
SEC. SOUND SAMPLE* 
310 PRINTPRINTSELECT (F)REQ/:PRINT 
TAB(7)*(B)ITS*:PRINTTAB(7)*(M)MU 
BLOCKS- 

320 GOSUB600:A-INSTR(1.TBM *,A$): ONA 
+1 GOTO 320,360,330.610.130 
330 PRINTPRINT'EhTTER NEW VALUE OF 
BITS PER*:PRINr SAMPLE (1-8)* 
340OOSUB600:BB>VAL(A$):IFBB<1 OR 
BB>6THEN340 

360 POKE BITS,256-2*(8-BB):GOTO300 
360 PRINTPRINTENTER NEW SAMPUNG 
RATE*:INPUr(500O.20,000 HZ)";RATE: 
IFRATEMyrHENGOTO300 
370 IFRATE<5000 THENRATE-5000 
380 IFRATE>2O033THENRATE»2OO33 
300 RATE»INT(3579645^RATE+.5) 
400 AF«INT(RATE/256):BF=RATE. 
2S6*AF:POKE FREQUENCY,AF:POKE 
FREQUENCY+1 ,BF:GOTO300 
410 RATE»INT(3579645/(256*PEEK 
(FREQUENCY)*PEEK(FREQUENCY+1 )) 
-►.5):CR«FNF1 pC):CB-PEEK(&H701 2):CL« 
PEEK(«H7013):RETURN 
420 ONBRKGOTO1X:GOSUB590 
430 PRINTPRINTTAB(5)*SPACEBAR TO 
RESTART* 

440 PRINTTAB(5)*SPACEBAR+BREAK FOR 
MENU* 

450 EXEC PLYBACK:GOT04eO 
460 CLS:PRINTTAB(10rSOUND 



MONITOR":PRINT 

470 GOSUB410:PRINTTAB(0)*CURRENTLY 
USING*;BB;'Brrs;;RATE;-HZ* 
480 PRINT:PRINTPRINT'SHIFT KEYS 
TOGGLE BETWEEN THE COCO DAC AND 
THE ORC« PAK*:PRINT'SET HARDWARE 
TO 6 BITS FOR 
TRUE*:PRINr'COMPARISON" 
400 EXEC MONITOR:GOTO130 
500RGB:WIOTH80:ENO 
510 PMODE3,5:PCLS1:SCREEN1.1 
520 UNE(1 1 6.50H1 1 8.50),PSET 
530 UNE(116,50H116,76),PSET 
540COLOR2,0 

560 UNE(116.76H116,178),PSET 
560 FORY«75.eT0178STEP25.6 
570 UNE(116.YH118,Y).PSETNEXT 
580 RETURN 

500 CLS:PRINTT AB(5)T LAYBACK IN 
PROGRESS--*fRW]TWnTAB{55rUSf«r,BBrBrTS 
Ar;RATE;*H2.*:RETURN 
600 A$BlNKEY$:IFA$»-n>IEN600ELSE 
RETURN 

610 PRINT'<ENTER> RETAINS CURRENT 
VALUE* 

620 INPUTENTER STARTING BLOCK #; 
MAX-53 

•A$:IFA$--THENe60ELSEBL-VAL(A$) 
630 IFBL>53THENPRINT*INVAUD MMU 
NUMBER":GOTO300 
640POKE&H7012,BL 
660 CR«FNF2(X):PRINT:PRINrENTER 
LENGTH OF SOUND SEGMENT IN SEC- 
ONDS (MAX«";CR;:UNEINPLrr) 
»*;A$:IFA$--n><EN300 ELSELG-VAL(A$) 
660 IFLG<-eTHENLG».6 ELSEIFLG>CR 
THENLG«CR 
670 POKE 

4H7013,IMT(2.571236671*LG+.5)+BLGOTO300 
700 POKE66406,0:CLS:PRINTTAB(10rDISK 1/ 
0*:PRINrSELECT (R)EAD (S)AVE* 
710 GOSUBeOO->»INSTR(1.*RS"A$):ONA+1 
GOTO 130,720,730 
720 EXEC 0READ:GOTO130 
730 EXEC DSAVE:GOTO130 

CavMts 

The d»k I/O routines are primative. Data 
» dumped directly to dtok in a format where 
there is no lie name and the entire disk is 
used for sound data. Make sure that the 
disks have been fonnatted to 40 tracks 
(you can use OS-9) and that there is no 
valuatDle data on the dtoksl 

If there are queettons. I can be reached 
via the magazine or through the internet 
at robertgaultQworkinetatLnet 

Happy hacking! I 
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RS'232 Communications witti CoCo 08-9 

Exploring transmission speed problems and lock-ups 



Jim Cross 



There are numerous factors that 
determine how fast a data commu- 
nications rate a CoCo can handle. 
These include the RS-232 hard- 
ware; specific OS-9 modules: ker- 
nel, lOMan. clock driver, device 
driver data buffer size; and the 
terminal program used. Ail of these 
factors combine to form the sys- 
tem limitation on the receiving data 
rate for any given CoCo. Since 
there are numerous editions of the 
modules and programs in drcula- 
tion, that rate is different for each 
differently configured CoCo. 

Last Christmas I added a 
14.4Kbps modem to my CoCo. I 
faced the problem of detenmining 
how fast a receiving data rate my 
Coco could keep up with under OS- 
9. Trial and error is one approach, 
but I found eariy on that approach 
on outside lines is inconclusive. 
During heavy net traffic, my servk:e 
provider slowed transmissions so 
that the higher data rates seem to 
woric fine. During lighter periods, 
however, I'd lose data while set at 
the same rate that had worked last 
time. 

I decided to try to measure how 
long it took my CoCo to process a 
received character. My DISTO 4- 
N-1 uses a 6551 ACIA which can 
only buffer 1 character, the CPU 
must read character #n before the 
6551 ACIA finishes receiving char- 
acter #n+1 or an overflow occurs 
and character #n is lost (overwrit- 
ten by character #n+1). Note that 
this method of measurement only 
worics if the ACIA is the only de- 
vice using the CART/ intenijpt sig- 
nal during the measurement pe- 
riod. Also, be sure no other pro- 
gram tasks (except your terminal 
program) are running or they might 
affect your results. 

I connected a 1(X) Mhz oscillo- 
scope to the CART/ interrupt line 
coming from the 4-N-1 at pin 8 of 



CoCo cartridge interface connec- 
tor. Triggering on the CART/ sig- 
nal going low (signifying a charac- 
ter has just been received), I ob- 
served the worst case time delay 
until the CART/ signal returned 
high (signifying that the CPU has 
read the character from the ACIA). 
It's true that events other within the 
ACIA besides character.received 
can cause an interrupt, but they are 
not nonmally encountered during 
data reception. Using my favorite 
terminal program (Supercomm), I 
logged onto my local provider us- 
ing 8-1 -None and dumped ail of my 
email to the CoCo's screen while 
observing the CART/ signal on the 
oscilloscope. Saving the data to 
disk may take more system time 
and thus can increase the worst 
case delay. On my system (6809) 
mnning Supercomm under OS-9 
(w/ Alan DeKok's TuneUp): best 
case time was approximately 80 
usee. = 12,500 cps (125,000 bps) 
but worst case time was about 
1.48 msec. = 675 cps ( 6750 
bps) 

This showed me that unless I 
changed something in my system 
to reduce my CioCo's worst case 
response time under OS-9, 1 could 
never reliably receive at rates of 
960 cps (9600 bps) or above no 
matter how large a receiving buffer 
I had (I currentiy use 2K buffers for 
receive and transmit). 

I tried RTS/DTR (CTS rewired) 
handshaking using a new RTS dr- 
cuit reputed to be from 
Sockmaster. This circuit stops data 
flow from the modem after every 
received character and restarts 
flow when the character is read by 
the CPU. My PM144MT II modem 
signals the remote modem to stop 
flow whenever RTS goes tow; I pre- 
sume other modems do also. While 
the new RTS circuit prevented re- 
ceiver overruns, the stop-to-restart 



delay between my modem and the 
remote modem was 10 msec < 
any data rate, that limited my ef- 
fective data rate to only 100 cps 
(1000 bps) regardless of tiie ACIA 
setting. One step forward, two 
steps back. 

The CoCo uses Asynchronos 
data transmission, the data rate 
standards for which define the bit 
times within a character, but tiiere 
is no limit to the amount of time that 
can occur between the end of one 
character and the beginning of tiie 
next unless tiie software imposes 
a timeout. This undefined 
intercharacter delay is why the 
CoCo can transmit at 19.2 Kbps 
but can't receive tiiat fast under 
OS-9, 

Also, one tiling many OS-9 us- 
ers may not realize is that if they 
are communicating with 7-1 -Even 
and the parameters xon and xoff 
are set to $1 1 and $13 respective! 
in their communications device 
descriptor (i.e.— /t2) with most se- 
rial device drivers tiiey are using 
XON/XOFF flow control. Botti pa- 
rameters must be set to 00 to dis- 
able XON/XOFF flow control. Un- 
less one knows what to look for, 
ttie XON/XOFF operation appears 
transparent and can hide the limit- 
ing efl^ects of too small of a receive 
buffer. 

If a reader has comments or 
speculation on this subject, i can 
be reached via intemet at: 

ac999@detroiLfreenet.org 

If you don't have intemet access, 
write ttie editor and your comments 
will be passed along. 
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Embedded programmer 

Exploring 68000 architecture 



Paul K. McKneely 



'n this articie we will explore the ar- 
iecture of the Motorola 68K family 
and begin to lay the foundation for a 
very powerful operating system. I will 
give a short review of its programmer 
model and then we'll discuss the 
processor's powerup process. 

Programmer's Model 

All members of the 68K family are 
modeled after the original 68000. It 
came in one of those large 64-pin DIP 
(Dual Inline Packages) that took up 
a lot of board space. It was quite a 
large part compared to the surface 
mount 68EC000 made today. 

Although the chip only has 16 data 
lines and 24 address lines, from the 
programmer's point of view, it is a 32- 
bit architecture. This was very fon^rd 
looking on the part of Motorola be- 
cause even at the time they started 
to design the chip they dM not have 
the ability to put that much circuitry 
onto one piece of silicon. I remem- 
^ literature back then saM it had 
.^.000 transistors. That number was 
easy to remember because it was its 
name. 

There are 8 general-purpose Data 
Registers (named DO thru D7) and 8 
general-purpose Address Registers 
(named AO thru AT). All are 32-bits 
in wklth. Operations on data are per- 
fonned in the low-order portion of the 
Data Registers and can be 8-bits, 16- 
bits, or 32-bits in size. The upper por- 
tions of the registers are generally not 
altered in 8 and 16-bit operations. 
When operations store their results 
in a Data Register, the flags in the 
Status Register (discussed below) 
generally reflect the stored value. 
This is even true of MOVE operations, 
something that makes the 68K differ- 
ent from other processois such as the 
80X86 where MOVEs dont alter the 
nags. A generalized Data Register is 
shown in table 1. 
Address registers are generally 
ed to contain and manipulate point- 
ers. They are also very efficient at 
handling signed integers, although 
operations that store values into them 
usually doni affect the flags. The in- 
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Status Register 
|T S jlPMI jXNZVq 
<- System Byte -><- User Byte — > 



structions that test and compare ad- 
dresses are the exceptions to this 
rule. Addresses are either 16-bits 
(Short Addresses) or 32-bits (Long 
Addresses) in size. 16-bft operations 
always affect the whole register be- 
cause the high ofder bit of the Short 
Address (bit 15) is always propagated 
through the upper half of the register. 
This is called 'Sign Extension'. 

Both kinds of addresses (Short and 
Long) point into the same 32-bit ad- 
dress space. When you use a Short 
Address, you can only reach a total 
of 64 KBytes of address space. But 
because of the sign extension, it is 
divkjed into two halves. The first 32K 
occupies the very beginning of 
memory ($00000000 thru 
$00007FFF) and the last 32K occu- 
pies the very end of memory 
($FFFF8000 thru $FFFFFFFF). The 
dollar sign indicates base 16 or hexa- 
decimal in the Motorola worid. Short 
Addressing is very efficient and we 
will be taking full advantage of it. 

The A7 register doubles as the 
Stack Pointer and is sometimes re- 
fened to as the SP. All instnjctions 



that Implicitly involve the Stack 
Pointer make use of A7. There are 
actually two A7 registers specifically 
referred to as the SSP (Supervisor 
Stack PointeO and USP (User Stack 
Pointer). Which one is active de- 
pends on the state of the Supervisor 
Bit in the Status Register. A general- 
ized Address Register is shown in fig- 
ure 2. In addition, there is a 16-bit Sta- 
tus Register (SR). This is dh^kled into 
an 8-bit System Byte and an 8-bit 
User Byte. This is diagramed in fig- 
ure 3. 

The System Byte contains three el- 
ements. Most important is the Su- 
pervisor Bit (S bit 13 above). When 
set (value is 1), the processor is sakj 
to be in Supervisor Mode. When clear 
(value is 0) it is sakl to be in User 
Mode. Supervisor Mode is more pow- 
erful because there are a set of Privi- 
leged Instructions that can be ex- 
ecuted when a program is running in 
that mode. The processor will not al- 
low these instructions to be executed 
when in User Mode. This bit also con- 
trols which of the two A7 registers are 
active. 
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HawkSoft 



28456 S.R. X New Cariitle, IN 46552 

219-654-7080 evet A emk MO, Ctwck, COD; US Futtk 

Shipping mchided for US, CoMda, ft Mexico 

MM/1 ProdncU (OS-9/68000) 

C1>F SSaOO - CD-ROM Fik Mnmger! IMkKk a wnltfa of files on CD with tbe M^ 
grtphia fixxn MS-DOS type CDk. 



VCDP SSaOO - New Virtual CD PUyer alkywi you to play audk) CDi on your MM/1 ! Gra^^ 
emulatei a pfaysica] CD player. Requires SCSI iiierftoe and NEC CD-ROM drive. 

KLOCK S2a00 • OpCiottal Cuckoo oo the hour and half bourl t Coadnuaaly diq)lays the digital time and 
date oo the /tenn screen or on aU open screena. Requires I/O boar4 I/O cable, audio cable, and s^^ 

WAVES vr 1^ S30il0 - Now supports 8SVX and WAV filea. AUows you to save and pUy aU or any part of 
a sound fiie. Mctbb files or split into pieces. Record, edit, and save fika; change playback/reoord speed. 
Convert nxxio to stereo and vioe-versat Record and play requires I/O board, cable, snd audio aquipmnnt 

MMn SOUND CABUSiaOO-Coonects MM/1 sound portto stereo equipmeitforreooning and paiyback. 

GNOP $&00 - Award winning version ofPONO(tm) exchisively for the MM/ 1 . You * U fo cnoytiying to b^ 
the dock and keep that @#$%& ball in line! ProCeaaional pongists everywhere swear by (at) itl Requires 
MM/1, mouse, and lots of patience. 

CoCo Producti (DECB) 

HOME CXINTROL SiaOO - Put your old TRS-80 Cokir Computer Phig n* Power oootroUer back on the 
job with your CoCo31 Cootrol up to 256 modulea, 99 events! Compatible with X- 10 modulea. 

HI A LO RES JOYSTICK ADAPTER $27.00 - Tandy Hi-Res adapter or oo adapter at the flick of a 
switch! No more phig and unphigging of the joystick! 

KEYBOARD CABI^ S25.00 - Five foot extender cable for CoCo 2 and 3. Custom lengths available. 



MYDOS Sl&OO • Customizable, EPROMable DECB enhancement The commands and options Tsndy left 
out! Supports double sided and 40 track drivee, dma disk access, set CMP or ROB palettes on power-up, 
oon» up in any screen size; Speech aiKl Sound Cartridge support, poiitf and click oaouae dtrectocy, and MORE 
OPTIONS thM you can shake a stick at! Requirea CoCo3 and DECB 2. 1. 

DOMINATION Sl&OO - Muhi-Ptayer strategy game. Battle other players armies to take control of the 
planet Play oo a hi-rea map. Become a Planet-Lord today! Requirea CoCo3, disk drive, and joystick or 



SMALL GRAFX ETC. 

''Y^ and TRT cables. Special 40 pin male/female end connectors, 

priced EACH CONNECTOR - $6.50 

Rainbow 40 wire ribbon cable, per foot - Sl.OO 

Hitachi 63B09E CPU and socket - $13.00 

MPI Upgrades for all smaU MPIs (satellite board) - $10.00 

Serial to Parallel Convertor with 64K buffer 

and external power supply - NOW ONLY $28.0011! 

Serial to Parallel Convertor (no buffer) 

and external power supply - ONLY $18.00!!! 

2400 baud Hayes compatible external modems - $15.00 

Serial to Parallel Convertm- or 

Modem cable (4 pin to 25 pin) - $5.00 

ADD $3.00 SAH FOR FIRST ITEM, $1.00 EACH ADDITIONAL ITEM 

SERVIC:E, parts, & hard to find software with COMPLETE 
DOCUMENTAnON AVAILABLE. INKS & REFILL KITS FOR C(a>-220, 
CANON, & HP INK JET PRINTERS, RIBBONS & vr. 6 EPROM FOR CGP- 
220 PRINTER (BOLD MODE), CUSTOM COLOR PRINTING. 

Terry Laraway 

41 N,W. Doncee Drive 

Bremerton, WA 98311 

360-692-5374 



••••••••••••••••••••• 

The BlackHawk M M/lb 

Based on the ATS 06 board from 
Krdder Electronics. Features bull' 
into tlie motherboard include: 

16 bit PC/AT.I/O bus with five slots 
MC68306 CPU at 16.67MHz 
S12K to 16MB of RAM with 

30 pin SIMMs (4 sockets) 
IDE Hard Drive Inter&ce (2 drives) 
360K- 1.44MB Floppy Drive 

Inter&ce (2 drives) 
Two 16 byte &st serial ports 

(uptoUSKbaud) 
Bi-directional parallel printer port 
Real-time clock 
PC/AT keyboard inter&ce 
Standard PC/AT power connector 
Baby AT size - fits standard PC case 
BASIC (resembles Microsoft 

BASIC) 
MC^ Graphical Windowing Envi- 
ronment with fiiO documentation 
'Tereonal" OS-9/68000 Vr 3.0 

(Industrial with RBF) 
Drivers for Tseng W32i and 

Trident 8900 VGA cards 
Drivers for Future Dc»nain 1680 and 

Adaptec AAHlSxx SCSI cards 
OS-9/68000 Vr 2.4 with Microware 
C 3.2, Assembler, MW Basic (like 
Basic09), MW Debug, MW Pro- 
grammers Toolkit 
UUCP from Bon Billson 
CHiostscript (software PostScript 

interpreter) 
Many other utilities and tools 

Prices start at S400! 

(motherboard. 

Personal OSK, & MGR only) 




BlackHawk 
Enterprises, Inc. 

56GauseBlvd. #29 

SKdell, LA 70458 

E-mail: ntmitz@stolY.com 
••••••••••••••••••••• 
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The next element of the System 
Byte is the 3-t)it Interrupt Priority Mask 
(IPM). This is a very powerful feature 
of the 68K that allows the processor 

control which intenrupts can occur, 
ais 3-t>it field can have a value from 
to 7. Level 7 is the highest priority 
and is the lowest. An IPM of a given 
value inhibits interrupts of lower or 
equal priority from occuring. One ex- 
ception to this rule is that level 7 in- 
terrupts can always occur because 
they are edge-triggered. All other in- 
terrupt levels are level-triggered. 

The final element in the System 
Byte is the Trace Btt (T bit 1 5 above). 
This feature allows the processor to 
single-step through a program with- 
out having to modify the program's 
instruction stream. This feature is fre- 
quently used by debuggers. The Sys- 
tem Byte is not accessit>le from User 
Mode. 

The User Byte of the Status Regis- 
ter contains five flags (X,N,Z,V,C). 
These values are accessible from 
both Supervisor and User Modes. 
The flags are generally modified 
when operations are performed on 

9ta Registers and their values are 
used in conditional branches. These 
flags are X (extend), N (Negative). Z 
(Zero). V (overflow), and C (Carry). 

One final register of great impor- 
tance is the Program Counter or PC. 
This is a 32-bit register that contains 
the address of the next instruction to 
be executed. Although this register 
is not a general-purpose register, it 
identifies the place where the cur- 
rently executing instruction resides 
and is often used to obtain related 
read-only information that is built in 
to the program's image. One very 
powerful class of addressing modes 
in the 68K is Program Relative Ad- 
dressing which is very important for 
writing Position Independent Code. 

Memory organization in the 68K is 
what is called Big-Endian. This 
means that the high-order byte of 
multi-byte values is stored at the first 
(lowest) address. Examples of other 
Big-Endian processors are the IBM 

lainframes and Midrange, Sun 
Microsystems SPARC, Zilog Z8000, 
and the IBM/Motorola PowerPC. Prx)- 
cessors that order their bytes the 
other way (lew-order first) are called 



Little-Endian. Some examples of 
these are the DEC PDP-11 . VAX, and 
Alpha, the MIPS R-XXXX RISC pro- 
cessors, and the Intel 80X86. Some 
of the more recent RISC processors 
can use either format but they all boot 
up in their "native modes'. 

Each system has its advantages 
and disadvantages. The Little-Endian 
byte ortJering is more natural and logi- 
cal but the Big-Endian method places 
printed data in an order that those 
reading from left to right like to see it 
when using the Arabic system for 
number representation. When look- 
ing at a hex dump of memory data on 
an IBM PC, for example, the bytes 
appear backwards and you have to 
mentally turn them around to under- 
stand them. The same hex dump on 
a 68K machine appears in the cor- 
rBct order. It was after my trip to Is- 
rael and Egypt last year that I real- 
ized that Arabs and Israelis probably 
prefer Little-Endian byte ordering. 
Even though we represent numbers 
in the same way, we read them in the 
opposite order t>ecause Arabic and 
Hebrew is read from right to left! 

The Powerup Process 

.One of the most interesting sub- 
jects to me is the sequence of events 
that happens when the 68000 first 
comes up atter either power on or re- 
set. The original 68000 requires the 
Reset pin to be heM low for a mini- 
mum of 100 milliseconds after power 
is applied to the chip. This ensures 
that all of the logic on the chip 
stablizes before execution begins. 

The 68000 has a 2S6-entry Excep- 
tion Vector Table that begins at loca- 
tion $00000000. Each entry is a 4- 
byte Long Word. Ail entries, except 
the zeroth one, are program address 
pointers. The first two entries are dif- 
ferent from the others and are used 
just after powerup. 

When the processor first comes 
alive, the Supervisor Bit Is set. The 
first thing that it does is to fetch the 
first long word from location thru 3 
and place it into the SSP (also called 
the ISP for Interrupt Stack Pointer). 
In the 68000, this requires two bus 
cycles because the Data Bus can 
only fetch two bytes at a time. 

Next, the processor fetches the 



second long word from location 4 thru 
7 and places it into the PC. This is 
the Reset Vector. All of the other 254 
Exception Vectors are used after the 
processor is up and running. 

But there's another important rea- 
son why these two long words are dif- 
ferent from the others. A typical cooh 
puter contains two kinds of memory: 
ROM and RAM. ROM is Read Only 
Memory and is generally non-volatile. 
RAM is Random Access Memory and 
is generally volatile. 

When power is first applied to the 
system, the very first memory that is 
fetched must come from ROM be- 
cause power has been off and RAM 
is in an unknown and uninitialized 
state. The first long word to be fetched 
becomes the working Stack Pointer 
value and shoukl come from ROM. 
The second is loaded into the PC and 
it must point somewhere into ROM, 
generally the same ROM it was stored 
in. The rest of the Exception Table 
can also point into ROM and often 
does in embedded systems because 
all program addresses are frequently 
pre-determined and burned into a 
ROM. But general purpose systems 
need to have the rest of the Excep- 
tion Vectors stored in RAM because 
vector addresses are often not known 
until run time, especially when using 
loadable device drivers. 

This gives us a choice to make: If 
all Exception JHandlers are known and 
fixed when the system is designed 
and built, the Boot ROM can be per- 
manently mapped beginning at loca- 
tion 0. This makes it simple but in- 
fiexiUe. If even one Exception IHan- 
dler has to be determined after boot 
time, then the table has to be stored 
in RAM. This means that RAM shoukl 
be mapped beginning at location 0. 
In this case we have a problem: The 
first two long words must come from 
ROM. 

There are at least three ways to 
solve this problem. Some system de- 
signers simply force the first two Long 
Words to map to the fiist eight bytes 
of the boot ROM. If RAM normally 
starts at zero this makes the first eight 
bytes of RAM inaccessible. But this 
is a small sacrifice. 

Another approach takes advantage 
of the fact that the first four accesses 
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after reset are known to be fetches 
for the ISP and PC values. This can 
also be done by simply Shadow Map- 
ping the boot ROM to location for 
the first four bus cycles, A reset cir- 
cuit temporarily disables the nomial 
address decoding logic during the 
first four accesses. 

Another common approach is to 
use the three Function Code pins on 
the chip. During each access, the 
chip identifies the cycle as either Pro- 
gram Space or Data Space. The 
fetches of the first two long words at 
reset are identified by the pixx^ssor 
as being program accesses. Fetches 
for any of the other vectors in the 
Exception Vector Table (during ex- 
ception processing) are identified as 
being in Data Space. After this reset 
process, RAM should appear begin- 
ning at location while ROM is some- 
where in high memory. 

After the first two long words have 
been loaded into the ISP and the PC, 
normal processing begins and the 
very first instruction is executed. It is 
a real thrill to write this very first in- 
struction. After doing it you feel like 
a real embedded programmer. Now 
let's write some startup code: 

;««<«««««««««« 

Boot ROM Image Code 
»»»»»»»»»»»»» 



SECTION boot 
Reset.ISP: DC.L ROM_Size 
Reset PC: DC.L Boot 



;Boot Parameters 

Paraml: DC,W $4000 ;lnter- 

mpt Stack Location 

;Reset execution begins here 
Bool: MOVE.W 
(Paraml, PC),A7 

OR #$0700,SR 

In the above example, Reset JSP 
is a symbol that is linked to the very 
first byte in the Boot ROM. Eariier I 
saki that the long word stored begin- 
ning at this locatton is loaded into the 
ISP at Reset. But what is stored there 
is a value called ROM.Size. 

Why am I doing this? Actually, I 
can load a new ISP value later on any 
time I want to. As long as I doni call 
a subroutine or do anything else that 
uses the stack pointer, it doesnt mat- 
ter at all that the value was loaded 
into the ISP before the processor 
started to run. 

I always use these first four bytes 
to record the number of bytes used 
in the Boot ROM. This is so that I can 
easily tell how long the Boot Image is 
that is stored in the Boot ROM. I wiH 
explain why I do this later when I ex- 
plain how the PREBOOT process 
works. 

Anyway, after these two values are 
loaded, program execution begins at 
the locatton labeled Boot. Here is my 
very first instruction. This instruction 
loads a new ISP value. But I am load- 
ing it from an eariier place in the Boot 
ROM using Program Relative Ad- 
dressing. This makes this instruction 
Position Independent. Also notice 
that I am loading a 32-bit Address 



Register with a 16-bit Short Address. 
This instruction loads the 32-bit 
Signed Extended value of $00004000 
into the ISR 

The first instruction labeled Boot 
can be located anywhere in 32-bik 
address space. I like to reserve the 
first several byte tocations in the Boot 
ROM to store pre-determined Boot 
Parameters. Since the program ex- 
ecution sequence can take many in- 
structions of indeterminate length, I 
have the Reset Vector point past this 
tat)le of Boot Parameters. Now look- 
ing at the ROM with either a software 
or hardware tool, I can easily view and 
even change them. 

We'll find out later why the Boot Im- 
age that is stored in the Boot ROM 
can actually be a changable image 
in RAM or on disk. It will become ap- 
parent why we keep the Boot Param- 
eters handy up at the front of the Boot 
Image. 

In the next article we'll take a 
deeper look at the advanced 68K in- 
terrupt structure. If you have any com- 
ments or requests, please feel free 
to write me at either 
<geckoQonramp.net> or at the ad- 
dress given below, 

Paul K. McKneely 
technoVenture. Inc. 
P O. Box 5641 
Pasadena, Texas 77508-5641 
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What Happened to Burke & Burke? 

Chris Burke 



Announcing Nitro Levd HI! 



How many times have you been un- 
able to load a driver due to not CTOugh 
system RAM? How would you like to 
' ^upto32KofsystemRAMavail- 
w .^? How is this possible? 

In efifect, Nitro Level m turns the sys- 
tem into a Kernel only process, vnth 
48K or RAM, and 2 10 processes (RBF 
and SCF), each with 16K of RAM. This 
is similar to Grfdrv having it's own 64k 
memory area. 

The kemd process contains the mini- 
mum modules to run an OS-9 system, 
and also die descriptors. Hie RBF/SCF 
processes contain the 10 modules, and 
the 10 buffers. 

There are 2 big benefits here: 

1 -Both RBF and SCF are not in sys- 
tem memory at the same time, so you 
save RAM. 

2 - You don't have 16K of SCF or 
RBF modules, so everything up to 16K 
can be used as device data storage (sec- 
tor buffers, etc.) 

Level in works <xily with Nitro (all 
versions). It can be purchased from 
'^ ^ RNA Systems al(Mie ($20) or widi 
_^ latest version of Nitro ($45 for Ni- 
tro v2.00 and Level III). See the 
FARNA ad in diis issue for ordering 
information. 



Burke & Burke is no k>nger in bustness, 
but Trisha and I are still togettier and liv- 
ing in Washington state, t still develop 
custom entertainment produclB (but not for 
the Cotor Computer) through my new ven- 
ture, Serotonin Software. 

You can see some of my handiwork in 
the Super Nintendo (SNES) version of 
Sinistar. one of the five classic arcade 
games hand translated from the original 
6809 code on the Wttams Arcade Great- 
est Hits cartrkige from WSams Entertain- 
ment and IDigital Eclipse Software. 

I cani provkle technk^l support for okj 
Burke & Burke products, txjt I still have 
some inventory and own the distr1butk>n 
rights for al txit a few. 

In honor of the 1997 Ch«ago CoCoFest, 
I've re-released several famiiar Burke & 
Burke products as shareware. Also, never 
before available, you'l find the source code 
and schematics for the popular CoCoXT 
and CoCoXT-RTC hard disk Interfaces. 
The shareware dtoks include text versnns 
of the manuals to make dMribution easier. 
If you value these products, even after so 
many years, you can send the shareware 
fee to me at Serotonin Software, denskle 
Cotor Computer Club wi handte dMribu- 
tion. 

Send requests for d»ks ak)ng with $3 
shipping and handing to: 
B&B Software 

c/o GlenskJe Cotor Computer Club 
119 Adobe Circle 
Carpentersvie, IL 60110-1101 



You may also send e-mai to: 
tonypodrazaQjuno.com 
for additk>nal information. 

Registrations fees shouki be sent to: 

Serotonin Software 

P.O. Box 1045 

Woodinvie, WA 98072-1045 

Orders for shareware WILL NOT BE 
PROCESSED at the Serotonin address! I 

Burke & Burke shareware pncing: 



Daggorpatch 


$5 


ZCIock 


$5 


Worid Ctaw Chew 


$5 


SCSI-512 


$5 


(this is by B&B, NOT the 


Matt Thompson Software!) 


EzGen 


$5 


Pertasdi 


$5 


Wid&MV 


$5 


XT-ROM 


$10 


(code only, not burned in ROM) 


File Recoveiy System 


$10 


RSB 


$15 


Fie System Repack 


$15 


PowerBoost 


$15 


CoCoXT Source Code 


$20 


EzGen Source Code 


$20 


Peftasci Source Code 


$20 




samcBSi. 



I wouM really like to run this as a regular colunnn. What I ann looking for is 
sources for hard to find and Iwrgaln items for CoCo. 68K, and general conn- 
puter use. If you find a treasure trove of good, inexpensive parts, let me know! 

5.25" 360K and 3.5" 720K Double Density Disks 

These are getting harderto find locally! Radio Shack has them, txit at a hefty 
price of $1 per box! These guys have 5.25* double skJed. double density disks 
(also used in single skJed drives) at $8.00 per 100 relabeled (used but tested 
good), or $8.50 for 50 new, 3.5' 720K disks are $12.50 for 50 or $24 for 1 00 (all 
new). These are UNFORMATTED prices. They can be purchased for a few 
dollars more preformatted for IBM compatibles. Call for prices on 1 .4M disks. 

Media Source Orders: 800-241-8857 

21 97 Canton Rd, FAX: 770-91 9-9228 

Suite 210 Bus Phone: 770-919-0059 

Marietta. GA 30066 E-Mail salesQmediasource.com 

Cor^buled by James H. Kkty <iUrt)y^fmiloeonttne.com> 
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Easy Disk Drive 

Convert an old IBM external drive for CoCo usel 



Roger Merchberger 



This is a short article about modfying 
an IBM external 525' 360K floppy drive 
to use it with your Tandy Color Computer 
(any modeQ. These drives are extremely 
wefl built (read: tanks), are of very high 
quality. Like everything else IBM, when 
the drives debuted. Tm sure they were 
extremely expensive as wel, but now they 
can be found for quite a reasonable price. 

If you get a complete drive (cable and 
aN) the liret thing you might think is that 
IBM went non-standard al ttie way, Ike 
usual. Thafs only hatf-true. IBM chose a 
37-pJn d-sub conr^ector for the cable so 
they couM easily supply al the necessary 
signals with an ample supply of ground 
Ines (half the Ines on a 44 pin connector 
are grounds). Many laptops stl use this 
connector for external floppy drives. 

The dmensions of this drive are 16" 
deep by 9** wide by 2.5 inches deep, and 
one wouM think they're made of armor 
plate due to the weight. The weight 
comes from the total RFI metal shieking 
aroifid the power sipply and ftoppy drive, 
and a rather high-capadty power supply, 
as wel. The 3.5' 720K model is simlar, 
but smaler. There may be some ott)er 
differences between the 5.25" and 3.5" 
drives. 

Here are the step-by-step instructfons 
to modHy the drive: 

Step 1 : Disassemble the case. You wl 
find 8 screws in the bottom of the case, 
6 of whk^h are standard philips, and the 
other two appear to be Torx screws, but 
with a post in the mkldte of the hole. Your 
best bet (and what I dM) is to bend the 
post out of the vwiy. jam a regular screw- 
driver that you wouldn't mind to get 
screwed up into two of the six points of 
the star that fit the best around the bent 
post, and don't bother to put them back 
in. This was, of course, before I owned a 
Dremel tod, and one co(id grind ttie post 
out and use a Tone driver, but that sounds 
too much Eke work to me. Once these 
two goofy screws are out of the way, you 
shouldn't find any more nonstandard 
screws. Once the case is opened, you 
need to remove the shiekJing from both 
the power supply and the ffoppy drive, to 
remove ttie nonstandard cable. 

Step 2. Once the cable is removed, you 
need to fit a standard CoCo ftoppy cable 
in the drive. There are several ways to 



do this, but I've only tried one. One way 
would be to thread a standard CoCo 
cable atong the same route as ttie oM 
one. If ttiis wl be your only drive, ttiat 
may work. If you wish to have more than 
one drive, this most probably wi not work. 
In ttiis case, you may have to go by Ra- 
dk> Shack and get a length of 40 con- 
ductor ribbon cable and three 40 pin 
crimp-on edge card connectors. Crimp 
one end on the cat>le and press it on the 
ffoppy drive. Run it akxig ttie path of the 
oM cable and out ttie case. Leave enough 
cable to attach your other drive and ttien 
extend to the contrder. Crimp a connec- 
tor on for ttie ottier drive and on ttie end 
for the controler. You can use two of ttie 
IBM drives by running a double length of 
cable in ttie second drive. I have seen 
drives run with three to four feet of rib- 
bon cable with no prot>lems. 

What I dkJ was this: When k>oking at 
the top front of the drive, measure IT 
back and T in from ttie left and cut a 
hole r wMe and .75" back in the drive. 
Thafs the size of ttie hole I made, but be 
sure to make alowances for a ttlle extra 
room if necessary to fit your cat>le. I cut 
this hole driing holes in the comers, and 
using a sat>er saw to cut the holes. A 
Dremel tool with a cutting blade woukJ 
be kJeal for this Job. The hole shouM be 
very near the ffoppy cable connector and 
drectly behind the rear EFI shieki for the 
ftoppy. 

Here comes the fiMi part you need to 
make a custom cat>le from standard IBM 
parts. Remember, al standard floppy 
cables have 34 pins. Go purchase an IBM 
ftoppy cabto thafs designed to add an 
extra ftoppy port for attaching a ftoppy- 
based tape drive. This cable usualy has 
three connectors, but only two are nec- 
essary: one is a MALE pin connector, and 
a standard okler card edge connector. 
Also purchase one of those littto 3.5** 
ftoppy adapters that diange from a pin 
connector to the older card edge connec- 
tor. 

Fit the ftoppy cable card^edge connec- 
tor through the hote, and in the shiekflng 
onto ttie ftoppy connector. Then carefuly 
screw down the shieking, securing the 
cable (t>e careful not to cut the ribbon 
cable... the metal is not extremely sharp, 
but it can cut the insulatton if you're not 



gentto...) ttien put ttie case back on. Pu' 
ttie 3.5** to 5.25" ftoppy corviector in the 
male pin connector, and fit this into one 
of ttie connectors on your standard Tandy 
cabto. 

Wtiat ttiis does is give you a "base" 
ftoppy, that a FD-500, FD-501 or FD-502 
sits on top of quite ntoely. If you have two 
drives in your FD-50X, you*! need to crimp 
on one more connector to ttie caUe, to 
make the extra spot for ttie IBM cable. 
This also means you need to split ttie 
outer casing on ttie cabto if you have a 
round ftoppy cat)to so you can attach an 
extra corviector. The round cabto has a 
flat rit)tx>n cabto roled up inskje and some 
extra stiiekSng. You can easfly split ttie 
case far enough back to fit an extra con- 
nector to fit ttie IBM cabto up from ttie 
IBM drive. 

One last thing: It is best to teave the 
terminating resistor on ttie IBM drive, as 
it is ttie least accessMe drive of Itie pack. 
Make it ttie last drive on ttie ftoppy chain. 
This also insures ttmt you have a com- 
patbte 525" ftoppy avalabto for trans- 
ferring ttiat oM software, and now you car 
modHy your FD-50x for one or two 3.5*^ 
72Kftoppie8forOS-9l 

The ftoppy arttole in ttie July/August 
1996 issue saki ttiat ttie FD-502 power 
8t4>ply is a Ittto weak. I have had the stan- 
dard Drive and a 1.4Meg 3.5** floppy 
Qumpered for 720K only operatton) mn- 
ning wittKHJt ttie fan with no prot>lems for 
over 3 years now. TTie 3.5" drives take 
much less power, and run just finel 

Atthetkne of this wridng, the IBM cases 
(wittKKit ftoppy) were for sato at B.G. Mi- 
cro for $10.00. Add $10.00 for a ftoppy, 
and some hardware hacking, and volal 
A wonderful ftoppy drive for your CoCo . 

If anyone has questions about this 
modHtoatton, or anything else that I migiit 
be abte to help you with, feel free to e- 
mail me at my Internet address: 
zmerchQ nor1tienriway.net 
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Year 2000... 

Are you ready, and is your CoCo? 



Robert Gault 



Just in case you have been off on a 

dsert island, when the year 2000 rolls 
around al hel wil break loose in computer 
land. Why is ttiat? Most computer systoms 
and software store only the last two d^jitB 
of a year in the date information. On Janu- 
ary 1, 2000 your computer may represent 
the date as Jan. 1. 1900. Some systems 
wi not give the wrong date. They wi lock 
up and cease to functx>nt 

The Gartner Group, Inc., an information 
technology research firm, has estimated 
that It wi cost between $300 bMon to $600 
bJlUon to correct the Year 2000 problem 
wofWwWel. Every program that uses a sbc 
dKlIt ASCII date field (mm/dd^) must be 
searched for each occunrence of the IMd 
and patched. Cost estimates vary, but to 
correct source code, $1 .10 per Ine is typi- 
cal. 

Many sentor executives are unaware of 
the problem. Many others doni understand 
it or dont beleve It to be serk>us. Worse 
stii, many Information Support engineers 
when asked say. 'Its no problem for me, t 
Intend to retire in 1999.' If you think this is 
sly. conskler this. Your new car five year 
warranty, which you just bought may al- 
ready have expired; ig96-*-5'= 
>D1 901 =1901 on a typteal system. Think 
of your bank accounts, stock holdings, 



social security— ai managed by computer 
systems. 

Where do you stand with your Coco? If 
you have never gone pest Disk Extended 
Basic you may be in good shape. I say 
may, because Disk Basic does not date 
disk files. Are you using any programs 
which incorporate dates? Better check 
them. 

If you have moved up to OS-9, you wi 
have problenra. Just how bad they wi be 
depends whether you use your Coco for 
fun or business. Lefs see where OS-9 
makes use of dates. 

Each dtok used in OS-9 has a creation 
date stored in logk^al sector zero (LSNO) 
in five bfytes; y:m:d:h:m. That means there 
is only enough room for the last two dKyts 
of the year. Each file descriptor contains 
two dates, creation and last riKxification; 
again using five bytes. Is this cosmetic, or 
will RBF (random block file manager) 
choke on a file whwh has a modification 
date of 00 with a creation date of 96? 

Ai the command level Date and Setime 
wi not work correcOy as the system does 
not leave enough room on the system di- 
rect page. There is only one byte for the 
year. A friend of mine has deckjed to patch 
Date to replace the hard coded *19' with 
*20.* He intends to switch to the new Date 



after the year 2000 but is that enough? 
The command 'dir e' wi let you access 
your fitos' creation dates but only displays 
two d^jitB for the year. Suppose you need 
to sort your fitos by date, what then? 

Any software that makes use of dates 
in OS-9 can be no better than the system. 
Do you use any software that automata 
cally Inserts the current date? Will your 
SmartWatch(r) or other hardware dock 
save you? No. it woni — it protmbly does 
not yiekj four dHjit years (the SmariWatch 
does not) and if it dkj. OS-9 cant use the 
information. Something to think about, isn't 
it? 

For the experimenter, Date can be 
patched by looking for the data string, 
$3189. This shoukJ be changed to $32B0 
and the CRC updated to make Date wortc 
correctty after 1/1/2000. The stock versnn 
of Data has '19* k>cated at the front of the 
module atong with other ASCII data. 

For more information, check out this 
internet web site: 

http://www.gartner.com/aboutgg/ 
pree8rel/pry2000. html 

I can be reached in care 
of this magazine or via 
internet at 

robertgauttQ 

woridnetattcom 




Disk EDTASM Modification 

Modify Edtasm to display on 40 or 80 column screens 



Here is a BASIC program that patches 
the originai EDTASM floppy to work on 40/ 
80 column screens. After patching, you'l 
need to put the CoCo into the 40/80 co^ 
umn screen, BEFORE running the 
'OOS.BAS* program on your EDTASM 
dWc A tiny one-iner caled 'EBAS' sets 
the screen width and p n l ott es to your own 
personal preferences, then runs DOS.BAS. 
The program E.B/\S looks Ike this: 

10 WIDTH80:PALETTE0,0:PALETTE 
8.63: ATTR 0,0:CLS1:RUN"DOS.BAS- 

This sets 80 column, white text on ttack 
tMckground, and runs DOS.BAS, listed 
t>ek>w. 

10 /»*=3DHEX$(PEEK(&H0FFFE))+ 
HEX$(PEEK(&HFFFF)) 
20 IF A$o'8C1B' THEN 
CLS:PRINrPATCH ONLY FOR COCO 
lll':END 



30 POKE 4H9692,17=7F 

40PCLEAR16 

50 POKE &H9eg2,9 

60 PALETTE 12,63 

70 PALETTE 13.0 

80 WIDTH 32:CLS:VERIFY ON 

90 IF FREE(PEEK(&H95A))<7 THEN 

PRINTDISK IS TOO FULL':END 

100 PRINTPATCHES FOR EDTASM TO 

RUN* 

110 PRINT 

120 PRINT 

130 PRINTINSERT COPY OF 

EDTASM' 

140 PRINT-PRESS ENTER WHEN 

READr 

150 A$=3DINKEY$:IF A$oCHR$(13) 

THEN 150 

160 PRINTLOADING EDTASM* 

170 RENAME'EDTASM.BIN' TO 

•EDTASM.OLD' 

180 LOADM'EDTASM.OLD' 

190 PRINTTATCHING...' 



200 READ AD$.DT$ 

210 IF AD$s30'END' THEN 240 

220 POKE 

VALC&H'+AD$).VALC&H'+DT$) 

230 GOTO 200 

240 PRINTSAVING...' 

250 SAVEM'EDTASM.BIN',&H1600. 

aH4A7F. &H1600 

260 PRINTDONE.' 

270 PCLEAR 4:CLEAR 

200.&H7FFF:NEW 

280 DATA 1617.84.1643.31.1D18,7F, 

1D10,FF 

290 DATA 1D1^DE.1D1B,6E.1D1C.9F. 

1D1D,FF 

300 DATA 1D1E.FE,1D1F,12,1D20,12, 

1D21,12 

310 DATA 1D22.12,1D23,12,1D3F.BD. 

1D40>M.1D41.B1,1D«2.12.1D7A,10.23B8,31 

320 DATA END.END 
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CoCo3 Extended Memory Secrets Part 2 

Practical use of CoCo3 Video 



iHerbert Enzman 



wnioauciion 

In PART 2 of this series, ri cover the prac- 
tice use of COCO 3 video. As in PART 1. 
some of this information might be know by 
you. but not to others, so some basics first 
We wi cover mostly the 80 column screen, 
with attributes. The NON-attribute screen wi 
be covered' in PART 3. 

Screen Memory Useage 

Super ECB (SEC6) has reserved block 
$36 for use of the screen memory, and maps 
it into SFFAI ($2000 - $3FFF) when it needs 
to dteplay the screen. In the attnbute mode, 
each screen LINE uses 160 bytes (80 for 
characters and 80 for attributes). Since there 
are normaly 24 fines per screen, then 160 X 
24 = 3840 bytes used by the screen. Since 
each BLOCK is 8K in size, you can see that 
less than half of bk)ck $36 is used for the 
screen. 

The screen mns from $2000 - $2EFF. with 
$2F00 - $3FFF unused by SECB (how to use 
that area later). When writing DIRECTLY to 
the 80 column screen, you must remember 
to send chtfacters to the EVEN address and 
the attribute byte to the ODD address, or 
some very strevige resutts wi occur. SECB 
takes care of this for you when you use its 
'character out" routine, but now It is up to you. 
TABLE 5 is a quk:k reference for wtvch HEX 
digit is ODD and whk:h is EVEN. 

$FFBO - $FFBF a^e used for the palette 
registers. $FFBO - $FFB7 are reserved for 
BACKGROUND cotors. af>d $FFB8 - $FFBF 
are resen/ed for the FOREGROUND cokxs. 
You can set-up each register with any cok)r 
(from $00 thru $3F) tfiat you like. 

SECB keeps 3 tables in memory for the 
palette registers, as shown by TABLE 7. The 
SECB MAIN table is used to resetthe palette 
registers on a hardware RESET, so if you 
dont wantthe cotors to change upon RESET, 
you shoukj also set the cotors of your choice 
in that tMe also. The other two tables are 
used for coto start or the commands 'CMP* 
or RGB*, they are the 'default tables. 

DISK EDTASM uses $FFB8 for its fore- 
ground myd $FFBO for its background; E/A 
6309 uses $FFB8 for foreground and $FFB4 
for background. Go ahead and use Z-BUG 
to change these registers for the cotors of 
your choice. Standard DISK EDTASM users 
wi want to set up an 80 cotomn screen (list- 
ing 2 from part 1 ) first 

Attributes... 

Now it is time to cover the ATTRIBUTE 
byte. TABLE 6 shows its format To he^ keep 
down corrfusion when catoulating the vatoe of 
the attribute byte, I recommer>d this format 
XX XXX XXX Start with bit 7 first and work 
your way to the right, as in this exampto: Lets 
say you want a yelow character on a black 



background that flashes; and The cotor yel- 
tow is tocated in palette register $FFBD and 
black in SFFB6. You woukJ first set bit 7 to a 
1 for flash(1XXXX XXX). Since you donlwant 
underiining. bit 6 is a (10 XXX XXX). Now 
you took at TABLE 4 for the foreground cotor 
(yelow is in $FFBD), find its BIN code tfid 
insert it into the byte (10 101 XXX). Next 
comes the background color (black in 
$FF66). and put its BIN code into the byte 
(10 101 110). Now al you have to do is to 
convert it into HEX (1010 1110 = $AE) and 
you have the attribute byte that needs to be 
sent to the screen with each character. 

You dont have to use the same attnbute 
for each character If you dont want to. You 
couki change the attribute tTyte for each char- 
acter sent but that wouto be quite contusing. 
Generaly you wouki want to use the same 
byte, at toast for the same ine of text But 
you CAN mix 8 foreground cotors arxi 8 t>ack- 
ground cotors on the SAME screen when you 
WRITE DIRECTLY to the screen. 

With SECB you ve stuck with two cotors. 
$FE08 is SECB's 'current attrtxjte temp'. You 
can change it when using the CHROUT rou- 
tine to change the attribute, but it woukJ be 
much easier just writing drecHy to the screen. 
You can e)9)eriment with this temp with Z- 
BUG's 'slash' command, to see what hap- 
pens. TABLE 7 shows what I have found so 
far for SECB's screen routine temps. 

The 'screen grids' in the COCO 3 manual 
a-e a ittto smal for c|utok use, so I woukI 
recommend that you tape several pieces of 
paper together and make yourself a larger 
'grid*. Make each grid square 1/4 by 3/8 
inches in size, so that you can write the ad- 
dress into each. Make it simlar to the grid on 
page 284. 80x24. then number each grid 
squa-e with an EVEN address Uust for char- 
acters) to keep dovwi confuston. Number each 
grid square with this format: 
$0000,$0002,$0004, ending with $OEFE The 
reason for using a in the first dKjit instead of 
a 2 is because btock $36 can be mapped 
into ANY $FFAx register. It now is an offset to 
be added to the address range of that btock. 

For example: let's say that you have 
mipped btock $36 into $FFA35FFAB ($6000 
- $7FFF). The screen wouW then start at 
$6000 instead of $2000, so addvig Oxxx to 
$6000 wouto give the proper address. In other 

words, si you have to change is the 1 St d^A 
when you map block $36 into a different 
$FFAx register. I know that it wi be a boring 
job to make this grid (I dto it), but it wi speed 
up findtog screen tocattons in the tong run. 

Practice makes perfect! 

Now that you have some informatton on 
screen use, it is time for some practtoe. DISK 
EDTASM users wi want to set up the 80 co^ 
umn screen, if you haveni done so yet Now 



enter Z-BUG In byte mode, and change ttie 
SFFBx registers to the cotors that you desirr 
Now, change $E0E4 to $36 (remember tfv^ 
f^om PART 1?) to map block $36 into the 
range of $6000 - $7FFF. Next, clear the 
screen with the 'CLEAR' key and do '6EC0 / 
- and put $41 there. You shouto see an "A' 
pop up in the tower part of the screen. Now 
do 'eECI r and put $AE there, and you 
shouto see a flashing 'A' with the cotors that 
you set up into $FFBD and $FFB6. Set 
$6EC1 to $EE and you wi see an underlined 
flashing 'A*. $6E wi give you just an uruier- 
Ined -A- and $2E wi give you a steady -A-. 

Now experiment with various other vetoes 
at $6EC1 to see how the attribute byte worics. 
Once the cursor gets down towards the 'A', 
you may have to dear the screen again to 
stop the 'A' fh)m scroing out of It's positton. 

E/A 6309 users wi have to use LISTING 
3 fh)m PART 1 to set btock $36 into $FFAB / 
$EOEC for this experiment (remember from 
ptft 1 as to why?). If E/A 6309 crashes when 
using $FFAB, then you wi have to switch to 
using $FFAC. As stated before. I am using 
the FIRST verston of E/A 6309. and the pro- 
gram ends at $54DF. and I understand that 
subsequent versions are different I don't 
know if the program is tonger and ends in the 
$6000 address range or not, the reason for 
thiewamir)g. 

This experiment demostrates severe 
things: 1 ) you can map btock $36 where ever 
you Rke and SECB wi sti dtoplay it 2) what 
the vartous values in ttie attribute byte wi dis- 
play. 3) more practtoe on btock switching. 4) 
the use of the $FFBx registers and 5) that 
you can have a multi-colored screen wtien 
writir)g dbw:1ty to it 

Listing explanations 

LISTINGS 5.6.7 are short demo programs 
that you can use to fiflher practice writing to 
the screen. 6 and 7 are the MAIN body pro- 
grams, and 5 is the sii>rout)ne that does most 
of the work. 

I have set USTING 5 up so that it has 3 
entry points for 3 purposes, tt wi work with 
both DISK EDTASM and E/A 6309 (the only 
difference is the $FFAx register as noted in 
the comment cotomn). The two instructtons 
•FCB $XX" »)d 'LDB #$XX* are where you 
putthe attrtxjte of your chotoe wtiere the XXs 
are. If you enter the subroutine at 'STRING', 
the B register wi be toaded with the attribute 
that PRECEEDS the text string, as you can 
see by the 'LDB -1 .X" instnjctton. If you want 
to use the same text, but with a different at- 
tribute, then PRELOAD the B register with the 
attribute »id enter the routine at *SCRIPr . "^ 
you are just sendtog one character to th 
screen, then PRELOAD the registers X,Y and 
B tfKJ enter at 'SCREEN'. I use a negative 
'stop' chapter in the text ine (FCB 'E-t-$80 
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in the isting) so if you add more text, do the same or the 
routine wi just WtZ thru memory unti it 1Mb a negative 
character. You w« notice that the routine swaps the block 
at the $FFAx registers and not the $EOEx registers be- 
cause we are writing dirwcttyti the screen and not going 
SECB's routine. This is an important thing to remem- 
. ^, USTING 6 wi get the attribute byte that proceeds the 
text string; and USTING 7 wi dfeplay the same string with 
a direrent attribute by loac^ the 'B' register ahead of time. 

To use the other half of the screen block, you wi have to 
change the pointers in SECB to drect it to the 2nd half. 
USTING 8 is a program that wi demonstrate the use of 
the second half. DISK EDTASM users shouki NOT use 
the code with •*", it is for E/A 6309 users only! Type it in, 
assemble and run it The cursor wi d»appear, and it wi 
seem Ike the program has crashed, but it hasnt The cur- 
sor is now kx^ated in the 2nd half of screen bk)ck, out of 
your view. You wi have to type BUND, so do this next step 
CAREFUUY You are sti in Z-BUG, so type 'B' for 'byte 
mode'; then type: TF9D T and change $FF9D to $DA. 
Youwinowbeinthe2ndhalfofthe screen bk>ck, and 
there is the cursor, binking happiy. 

To get back to the 1 st half of the screen bdock, change 
$FF9D to $D8. 1 wi get Into more detai on $FF9D in the 
next installment For now, to toggle between the two 
screens, just set $FF9D between $DA for the 2nd half and 
$D8fbrthe 1st half. The Istscreen is: $2000-$2EFF and 
the 2nd s $3000 - $3EFF With some imagination, you 
can merge this infbrmatkxi and have plenty to play with 
until next time 



Part 3 w« be... 

Next time I wi dfficuss what I have found with the NON- 
attribute screens and the other JFF9X registers. This in- 

TiatxHi is pretty interesting and with some imagination, 

^1 be very useftJ. 
USTING 5- Write to screen routine ANDCC 

RTS 
UPON ENTRY: X = Points to text that is to be 
printed to screen. Y = iocatkxi on screen to put SAVE RMB 
tsxt 8 = SEE TUTORIAL TEXT 



TABLE 4 


TABLES 


TABLE 6 


HEX 












FORE BIN 


SACK 


ODD 


EVEN 


BIT 


USAGE 


$FFB8 000 


$FFBO 


00 


01 


7 


1«blnk 


$FFB9 001 


$FFB1 


02 


03 


6 


1'undarflne 


SFFBA 010 


$FFB2 


04 


06 


5 


• 


SFFBB Oil 


$FFB3 


06 


07 


4 


* foreground (B8-BF) 


SFFBC 100 


$FFB4 


06 


09 


3 


• 


$FFBD 101 


$FFB5 


QA 


06 


2 


i 


$FFBE 110 


$FFB6 


OC 


OO 


1 


fbwliaraund(B0-B7) 


SFFBF 111 $FFB7 OE OF Of 



TABLE 7 - PaMte register tables 



AU 



HEX 



SECB SCREEN TEMPS 



HARD 


SECB 


CMP 


ROB 


WARE 


MAIN 


SETUP SETUP 


FFBO 


E678 


E664 


£664 


FFB1 


E679 


E666 


c6^D 


FFB2 


E67A 




E666 


FFB3 


E67B 


E667 


£667 


FFB4 


E67C 


E668 


£668 


FFB5 


E57D 


E6G0 


£669 


FFB6 


E67E 


E66A 


E66A 


FFB7 


E67F 


E66B 


E66B 


FFB8 


E680 


E66C 


£66C 


FFB9 


E661 


£660 


£660 


FFBA 


E682 


E66E 


E66E 


FFBB 


E683 


E66F 


E66F 


FFBC 


£684 


£660 


£670 


FFBO 


E686 


£661 


£671 


FFBE 




£662 


£672 


FFBF 


E667 


E663 


E673 



$FEOQ/ai 


Cursor localion 


$FE02 




$FE03 


worldnglne count 


$FE04 


ichar.psrine 


$FE06 


# loss per scresn 


$FE06^ 


scrssn end location 


$FE06 


currant aOiftNJte 


SFEOQ 


unused 


$FE0A 




$FE06 


badqground color 



i$AF enable intsrupts 
relumfor more charactars 

1 **tBmp for currant block « 



LISTING • 'Second* scfeen demo 



STRING LDB -1,X 

get attribute that is before taxt string 

SCRIPT LDA ,X+ get text charactBT 

PSHS A 
save for stop charactsr test 

BSR FIX sand it to ttw screen 

TST ,S+ 
was CharactBT a STOP char, (negative)? 

BPL SCRIPT 
no, loop for more charactsrs 

RTS DONE - return 

FIX ANDA #$7F drop MSB first 
SCREEN PSMS Dsave for after block swap 

ORCC #$50 diaable intampte 

LDA «$36 
= BLOCK « that screen uees 

LDB $FFA3 -^ $FFAB for 6309 users 

STB SAVE 
save current block # for return 

STA $FFA3 -^ $FFAB 

PULS 
. character and its attribute 

STD .Y-M- store both to the acreen 

LDB SAVE 
gat original bk)ck « that was saved 

STB $FFA3 **• $FFAB 



FCB XX 
PUT desired attribute here in place (rf XX* 
TEXT1 FCC /YOUR MESSAGE HER/ 

FCB '£+$80 
thie ia for STOP printing code 

END 



U8TIN06 


GO LEAX TEXT1.PCR 


LDY #$2AF0 


BSR STRING 


SWI 


LISTING 7 


GO LEAX TEXTI.PCR 


LDY #$2AF0 


LDB «$XX = attribute 


BSR SCRIPT 


SWI 


•LISTINGS 6 AND 7 cal USTING 5. — 


SEE TEXT 



CODE with -** is for E/A 6309 users 
onlylttnil 

GO NOP 

• CLR $FF91 setTR=0 
LDA «$3F 

and a dd r eaa of second ecrsan (msb) 

STA $FE06 set ft for SECB 

STA $F688 set it for SECB 

DECA *Anow«$3E 

STA $F875 est SECB 

LDA #930 

STA $F7BC 
set stvt address of second scraan (msb) 

STA $F680 set SECB 

STA $F6A3 set SECB 

STA $F6D5 set SECB 

JSR $Fe79 
Now eet up 80 column screen 

• LDA #1 ii# 

• STA $FF91 iff eetTR=1 
LDD #$3600 set ecreen odors 
STA $FFB8 setforsgroundtoydkyw 
STB $FFB0 

set background to btack (dtekedtaam) 

• STB $FFB4 

aet background to btack (e/a6300|^ 

STB $FF9A 
set borctar to black 

SWI FINISHED 

END 
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RGBoost-$15.00 

If you want to speed up DECB easily, install an Hitachi 
6309 and get RGBoost. This patch for DECB uses the ex- 
tra 6309 functions for up to a 15% gain in overall speed. It 
is compatible with all progranns tested to date! Save an 
additional $5 by purchasing RGBoost along with one of 
my other products listed below! 

Potch«s Tandy's Disk EDTASM to support Hitochi 6309 codesi Sup- 
ports all CoCo models, including $»ock 6809 models. CoCo 3 ver- 
sion uses 80 column screen, runs ot 2MHz. YOU MUST H/l/E A 
COPY OF DISK EDTASM. This is a fWCH ONIYI It will not work 
with 'disk patched' cartridge EDIASM 

Receive and print weother fascimile maps from shortwavel The US 
weather service sends them all the timet Requires 512K G>Co3 
and shortwave receiver. Instructions for simple cable included. 

HMDOg->M.OO 

Move programs and data between DECB and OS-9 disksl Sup- 
ports RGB-DOS - move files easily between DECB and OS-9 par- 
titionsl No modifications to OS-9 modules required. 



Access your SmartWotch from DECBt Adds function to BASIC 
(D/JE$) for accessing date and Hme. Ofiiy $15,00 wHh any othm- 
purchasmi 

Kobert Gautt 

332 N. Kenaud 

Gro&ee Points V4ood0. Ml 4&236 

315-&&1-0335 

Please add $4 S&H per order 



for all your CoCo h<Kclmire needs, cor^nectwilh 



CoN 



ECT 



1629 South 61st Street 
West Allis,WI 53214 

(putandOofnni(M.uwni.«du) 



That thing that Tandy calls a serial port on the CoCo 
has always been a problem. It was designed with 
minimal cost in mind, and never upgraded. Even 
Tandy tried to fix it with their RS-232 Pak, but even it 
was only half done! Our Fast 232 port uses a 1 6 byte 
buffer at aleviate missed characters at any speed and 
also has ALL RS-232 lines implemented. It is easy to 
set up with jumpers for different addresses. A 
daughterboard can be purchased to easily odd a 
second fast serial port! And aH this in a cartridge the 
size of a ROM Palcl 6809 and 6309 OS-9 drivers in- 
cluded. Completely supports up to 57.600 bps, lim- 
ited support for 1 15.000 bps. 

Fost 232 - $79.95 
Dougtit«r Board - $45.00 

Check with us for compile disk drive systems, 
misc. hardware items, hrffdware repairs, and hard 
to fhd new and used COCO softwarei 



STRON«WiltRE 



Box 361 Matthews. IN 46957 Phmie 317-998-7558 




CoCo 3 Software: 

Soviet Bloc 

GEAAS 

CopyCot 

HFE- HPrint Font Editor 

AAWl Software: 
Graphics Tools 
Starter Pak — 
BShow 
CopyCot 
Painter 



$25 

- $15 

$5 

— $10 

-- $35 



ADVERTISER'S IN 


]DEX 


BlackHmvk Enterprises 


13 


CoNect 


21 


FARNA Systems 


6,16 


Robert Gault 


21 


Hawksoft 


13 


Dennis Kitsz 


4 


PACoCoFest 


EC 


SmattGn^ 


13 


StrongWare 


21 



What are vou waitine for? 

Get your friends to subscribe to 

the only magazine that still supports 

the Tandy Color Computen.. 

"Hhe world of 68* mawTl 

The more people who want the support 

the longer it win be here! 
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August 2 & 3, 1997 
(Sat. 10am-5pm; Sun. 10am-3:30pm) 

at the 

EMBERS INN 

1700Harrisburg Pike 
Carlisle, PA 

Overnight room rate: $60 
Be sure to ask for the "FEST'ratel 

Exit 1 6 off of the PA Turnpike 1-76 

Turn to Harrisburg, go 1 .3 miles, it's on the right. 

OR 1-81 Exit 17, turn left, go 1/1 0th mile, on the right. 



There is even more information 
on Ron Bull's Web site! 
www.geocities, com/Silicon Valley 
/Vista/1412/BullsBarn.html 




Vendors who plan to attend: 



Elite Software 

PA Online 

Carl Boil 

StrongWare 

SBug 

Bargeman Research Labs 

MonltWare 

CoNect 

Alan Dages 



SubEtha Software 
R.C.Smith 
FARNA Systems 
Ricl( Cooper-CFDM 
Adventure Survivors 
Unlimited Electronics Repair 
Paul W. Zibaila III 
Black Hawk Enterprises 
Glenside CoCo Club 



Call 1-717-243-1717 OR 
1-800-692-7316 OR Fax 
(717) 243-6648 for 
reservations! Limited 
supply of rooms reserved 
for the show. Rooms will 

be released on July 1 
and will NOT be available 

at the show rate! 
ADiy/IISSION: $5.00 per 

person per day 

or $7.00 for both days 

(paid in advance). 

Children under 10 

accompanied by a 

responsible adult are free! 



For fiirther iaformation, general or ex- 
hibitor, contact: 

Ron Boll 

115 Ann Street 

Duncannon, PA 17020-1204 

(717) 834-4314 

OR Email me: ronbaU@aoLcom 

FEATURED GUESTS: 
Steve Bjorfc - Bring your ZAXXON and 
Gwana Bwana mannala - be said be 
would autograph them for yoai Will be 
giving a seminar on game programming 
in general. 

Kevin Darling - WiU enlightoi us with 
'^S-9 and Multimedia'* 

Marty Goodman - may do a seminar! 
One (rf the most infamous CoCo person- 
alities still with us... or is that the most 
infamous of us all??? 



For a FREE PA State map and Visitor's Guide call 1-800-VISIT-PA - Ifs FREE! 
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